NSValueTransformer

Overview 概要

You create a value transformer by subclassing NSValueTransformer and overriding the necessary methods to provide the required custom transformation. You then register the value transformer using the setValueTransformer:forName: method, so that other parts of your app can access it by name with valueTransformerForName:. あなたは、値変換器の作成を、NSValueTransformerのサブクラスを作成して必要なメソッドをオーバーライドして望むあつらえの変換を提供することで行います。あなたはそれから値変換器をsetValueTransformer:forName:メソッドを使って登録します、そうしてあなたのアプリの他の部分は名前によってそれにアクセスすることがvalueTransformerForName:で可能です。

Use the transformedValue: method to transform a value from one representation into another. If a value transformer designates that its transformation is reversible by returning YES for allowsReverseTransformation, you can also use the reverseTransformedValue: to perform the transformation in reverse. For example, reversing the characters in a string is a reversible operation, whereas changing the characters in a string to be uppercase is a nonreversible operation. transformedValue:メソッドを使ってある値を１つの表現から別のものへと変換してください。ある値変換器がそれの変換が元に戻せることをYESをallowsReverseTransformationに対して返すことによって示すならば、あなたはまたreverseTransformedValue:を使って逆での変換を実行してください。たとえば、ある文字列中の文字を逆にすることは元に戻せる操作です、その一方である文字列の中の文字をアップケースであるように変えることは元に戻せない操作です。

A value transformer can take inputs of one type and return a value of a different type. ある値変換器は、１つの型の入力を取り、そして異なる型の値を返すことが出来ます。 For example, a value transformer could take an NSImage or UIImage object and return an NSData object containing the PNG representation of that image.

Example Usage 使用例

The following example defines a new value transformer that takes an object and returns a string based on the object’s class type. This transformer isn't reversible because it doesn't make sense to transform a class name into an object. 以下の例は、ある新しい値変換器を定義します、それはあるオブジェクトを取り、そのオブジェクトのもつクラス型に基づいてある文字列を返します。この変換器は、可逆ではありません、なぜならそれはクラス名をオブジェクトへと変換することを理解できないからです。

@interface ClassNameTransformer: NSValueTransformer {}
@end
@implementation ClassNameTransformer
+ (Class)transformedValueClass { 
    return [NSString class]; 
}
+ (BOOL)allowsReverseTransformation { 
    return NO; 
}
- (id)transformedValue:(id)value {
    return (value == nil) ? nil : NSStringFromClass([value class]);
}
@end