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

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). このメソッドは、欄内の文字列へのユーザの変更を検証したいサブクラスにおいて実装されるべきです、そこにおいてユーザのする変更は、必ずしも文字列の終わりにではありません、そして選択の維持(または異なるものを設定すること、例えばユーザがタイプした文字列の誤り部分の選択など)ではありません。

Declaration 宣言

func isPartialStringValid(_ partialStringPtr: AutoreleasingUnsafeMutablePointer<NSString>, 
    proposedSelectedRange proposedSelRangePtr: NSRangePointer?, 
           originalString origString: String, 
    originalSelectedRange origSelRange: NSRange, 
         errorDescription error: AutoreleasingUnsafeMutablePointer<NSString?>?) -> Bool

Parameters パラメータ

partialStringPtr

The new string to validate. 検証されることになる新しい文字列。

proposedSelRangePtr

The selection range that will be used if the string is accepted or replaced. 選択範囲、それは文字列が受諾されるか置換されるならば使われます。

origString

The original string, before the proposed change. 提案される変更より前の、元の文字列。

origSelRange

The selection range over which the change is to take place. 選択範囲、それに対して変更が行われます。

If the user change is a deletion, origSelRange contains the range of the deleted characters. ユーザの変更が削除ならば、origSelRangeは削除された文字の範囲を含みます。

error

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

Return Value 戻り値

true if partialStringPtr is acceptable, otherwise false. true、もしpartialStringPtrが受け入れ可能ならば、そうでなければfalse

Discussion 議論

In a subclass implementation, evaluate partialString according to the context. Return true if partialStringPtr is acceptable and false if partialStringPtr is unacceptable. If you return false and assign a new string to partialStringPtr and a new range to proposedSelRangePtr, the string and selection range are changed, otherwise, if no values are assigned to partialStringPtr or proposedSelRangePtr, the change is rejected. If you return false, 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:. サブクラス実装では、文脈によってpartialStringを評価してください。trueをもしpartialStringPtrが受け入れ可能ならば、そしてfalsepartialStringPtrが受け入れ可能でないならば返してください。あなたがfalseを返して新しい文字列をpartialStringPtrにそして新しい範囲をproposedSelRangePtr割り当てるならば、文字列と選択範囲は変更されます、そうではなくて、値がpartialStringPtrまたはproposedSelRangePtrに割り当てられないならば、変更は却下されます。あなたがfalseを返すならば、あなたはまた遠回しにNSStringオブジェクトを(errorにおいて)返すことができます、それはなぜ検証が失敗したか理由を説明するものです;セルを管理するNSControlオブジェクトの委任先(もしあれば)は、そのとき control:didFailToValidatePartialString:errorDescription: での失敗に応答できます。

See Also 参照

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