- isPartialStringValid:newEditingString:errorDescription: Returns a Boolean value that indicates whether a partial string is valid.
不完全な文字列が有効かどうかを指し示すブール値を返します。
The new string to validate. 検証されることになる新しい文字列。
Instance Method
インスタンスメソッド
is
isPartialStringValid:proposedSelectedRange:originalString:originalSelectedRange:errorDescription:
This method should be implemented in subclasses that want to validate user changes to a string in a field, where the user changes are not necessarily at the end of the string, and preserve the selection (or set a different one, such as selecting the erroneous part of the string the user has typed).
このメソッドは、欄内の文字列へのユーザの変更を検証したいサブクラスにおいて実装されるべきです、そこにおいてユーザのする変更は、必ずしも文字列の終わりにではありません、そして選択の維持（または異なるものを設定すること、例えばユーザがタイプした文字列の誤り部分の選択など）ではありません。
Availability 有効性
- iOS 2.0+
- iPadOS 2.0+
- macOS 10.0+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
Technology
- Foundation ファウンデーション
Declaration 宣言
- (BOOL)isPartialStringValid:(NSString * _Nonnull *)partialStringPtr
proposedSelectedRange:(NSRangePointer )proposedSelRangePtr
originalString:(NSString *)origString
originalSelectedRange:(NSRange)origSelRange
errorDescription:(NSString * _Nullable *)error;
Parameters パラメータ
partialStringPtrproposedSelRangePtrThe selection range that will be used if the string is accepted or replaced. 選択範囲、それは文字列が受諾されるか置換されるならば使われます。
origStringThe original string, before the proposed change. 提案される変更より前の、元の文字列。
origSelRangeThe selection range over which the change is to take place. 選択範囲、それに対して変更が行われます。
If the user change is a deletion,
origcontains the range of the deleted characters. ユーザの変更が削除ならば、Sel Range origは削除された文字の範囲を含みます。Sel Range errorIf non-
nil, if validation fails contains anNSStringobject that describes the problem. 非nilならば、検証失敗ならば問題を記述するNSStringオブジェクトを含みます。
Return Value 戻り値
YES if partial is acceptable, otherwise NO.
YES、もしpartialが受け入れ可能ならば、そうでなければNO。
Discussion 議論
In a subclass implementation, evaluate partial according to the context. Return YES if partial is acceptable and NO if partial is unacceptable. If you return NO and assign a new string to partial and a new range to proposed, the string and selection range are changed, otherwise, if no values are assigned to partial or proposed, the change is rejected. 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:.
サブクラス実装では、文脈によってpartialを評価してください。YESをもしpartialが受け入れ可能ならば、そしてNOをpartialが受け入れ可能でないならば返してください。あなたがNOを返して新しい文字列をpartialにそして新しい範囲をproposed割り当てるならば、文字列と選択範囲は変更されます、そうではなくて、値がpartialまたはproposedに割り当てられないならば、変更は却下されます。あなたがNOを返すならば、あなたはまた遠回しにNSStringオブジェクトを（errorにおいて）返すことができます、それはなぜ検証が失敗したか理由を説明するものです；セルを管理するNSControlオブジェクトの委任先（もしあれば）は、そのとき control:didFailToValidatePartialString:errorDescription: での失敗に応答できます。