Instance Method インスタンスメソッド

isPartialStringValid:newEditingString:errorDescription:

Returns a Boolean value that indicates whether a partial string is valid. 不完全な文字列が有効かどうかを指し示すブール値を返します。

Declaration 宣言

- (BOOL)isPartialStringValid:(NSString *)partialString 
            newEditingString:(NSString * _Nullable *)newString 
            errorDescription:(NSString * _Nullable *)error;

Parameters パラメータ

partialString

The text currently in a cell. 現在セルの中にあるテキスト。

newString

If partialString needs to be modified, upon return contains the replacement string. partialStringが修正される必要があるならば、戻りにおいて交換用文字列を含みます。

error

If non-nil, if validation fails contains an NSString object that describes the problem. nilならば、検証失敗ならば問題を記述するNSStringオブジェクトを含みます。

Return Value 戻り値

YES if partialString is an acceptable value, otherwise NO. YES、もしpartialStringが受け入れ可能ならば、そうでなければNO

Discussion 議論

This method is invoked each time the user presses a key while the cell has the keyboard focus—it lets you verify and edit the cell text as the user types it. このメソッドは、セルがキーボードフォーカスを持つ間は、ユーザがキーを押すたびに発動されます — それはあなたにセルテキストを、ユーザがそれをタイプするにつれて検証および編集させます。

In a subclass implementation, evaluate partialString according to the context, edit the text if necessary, and return by reference any edited string in newString. Return YES if partialString is acceptable and NO if partialString is unacceptable. If you return NO and newString is nil, the cell displays partialString minus the last character typed. If you return NO, you can also return by indirection an NSString object (in error) that explains the reason why the validation failed; the delegate (if any) of the NSControl object managing the cell can then respond to the failure in control:didFailToValidatePartialString:errorDescription:. The selection range will always be set to the end of the text if replacement occurs. サブクラス実装では、文脈によってpartialStringを評価して、必要ならばテキストを編集して、そして参照によって何らかの編集済み文字列をnewStringにおいて返してください。YESをもしpartialStringが受け入れ可能ならば、そしてNOpartialStringが受け入れ可能でないならば返してください。あなたがNOを返すそしてnewStringnilならば、セルはpartialStringからタイプされた最後の文字を引いたものを返します。あなたがNOを返すならば、あなたはまた遠回しにNSStringオブジェクトを(errorにおいて)返すことができます、それはなぜ検証が失敗したか理由を説明するものです;セルを管理するNSControlオブジェクトの委任先(もしあれば)は、そのとき control:didFailToValidatePartialString:errorDescription: での失敗に応答できます。選択範囲は、置換が発生するならば、常にテキストの終わりに設定されます。

This method is a compatibility method. If a subclass overrides this method and does not override isPartialStringValid:proposedSelectedRange:originalString:originalSelectedRange:errorDescription:, this method will be called as before (isPartialStringValid:proposedSelectedRange:originalString:originalSelectedRange:errorDescription: just calls this one by default). このメソッドは、互換メソッドです。サブクラスがこのメソッドをオーバーライドするそしてisPartialStringValid:proposedSelectedRange:originalString:originalSelectedRange:errorDescription:をオーバーライドしないならば、このメソッドは前と同じく呼び出されるでしょう(isPartialStringValid:proposedSelectedRange:originalString:originalSelectedRange:errorDescription: は、初期状態で単にこのものを呼び出すだけです)。

See Also 参照

Validating Partial Strings 部分的な文字列を検証する