Ссылка на протокол NSControlTextEditingDelegate

Проверка значения управления


    
    управление (_: isValidObject:)
    - control:isValidObject:

Вызванный, когда точка вставки оставляет ячейку, принадлежащую указанному управлению, но прежде чем значение объекта ячейки выведено на экран.

Объявление

Swift

optional func control(_ control: NSControl, isValidObject object: AnyObject) -> Bool

Objective C

- (BOOL)control:(NSControl *)control isValidObject:(id)object

Параметры

`control`	Управление, объектное значение которого должно быть проверено.
`object`	Объектное значение для проверки.

Возвращаемое значение

YEStrue если Вы хотите позволить управлению отображать указанное значение; иначе, NOfalse отклонить значение и возвратить курсор ячейке управления.

Обсуждение

Этот метод дает делегату возможность проверить содержание ячейки управления (или выбранная ячейка). В проверке делегат должен регистрировать значение object параметр и определяет, находится ли он в пределах допустимого диапазона, потребовал атрибутов, соглашений с данным контекстом, и т.д. Примеры объектов, подвергающихся таким оценкам, NSDate объект, который не должен представлять будущую дату или денежную сумму (представленный NSNumber объект), который превышает предопределенный предел.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.

Доступный как часть неофициального протокола до OS X v10.6.


    
    управление (_: didFailToValidatePartialString:errorDescription:)
    - control:didFailToValidatePartialString:errorDescription:

Вызванный, когда средство форматирования для ячейки, принадлежащей control (или выбранная ячейка), отклоняет частичную строку, которую пользователь вводит в ячейку.

Объявление

Swift

optional func control(_ control: NSControl, didFailToValidatePartialString string: String, errorDescription error: String?)

Objective C

- (void)control:(NSControl *)control didFailToValidatePartialString:(NSString *)string errorDescription:(NSString *)error

Параметры

`control`	Управление, ячейка которого отклонила строку.
`string`	Строка, включающая символ, вызвавший отклонение.
`error`	Локализованная, презентабельная пользователем строка, объясняющая, почему была отклонена строка.

Обсуждение

Когда пользователь вводит неправильно форматированный текст, можно реализовать этот метод, чтобы вывести на экран предупреждающее сообщение или выполнить подобное действие.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.

Доступный как часть неофициального протокола до OS X v10.6.

См. также

isPartialStringValid:newEditingString:errorDescription: (NSFormatter)

Ответ на текстовое форматирование


    
    управление (_: didFailToFormatString:errorDescription:)
    - control:didFailToFormatString:errorDescription:

Вызванный, когда средство форматирования для ячейки, принадлежащей указанному управлению, не может преобразовать строку в основной объект.

Объявление

Swift

optional func control(_ control: NSControl, didFailToFormatString string: String, errorDescription error: String?) -> Bool

Objective C

- (BOOL)control:(NSControl *)control didFailToFormatString:(NSString *)string errorDescription:(NSString *)error

Параметры

`control`	Управление, ячейка которого не могла преобразовать строку.
`string`	Строка, которая не могла быть преобразована.
`error`	Локализованная, презентабельная пользователем строка, объясняющая, почему преобразование перестало работать.

Возвращаемое значение

YEStrue если значение в строковом параметре должно быть принято, как; иначе, NOfalse если должно быть отклонено значение в параметре.

Обсуждение

Ваша реализация этого метода должна оценить ошибку или запросить пользователя надлежащее значение, указывающее, должна ли строка быть принята или отклонена.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.

Доступный как часть неофициального протокола до OS X v10.6.

См. также

getObjectValue:forString:errorDescription: (NSFormatter)

Ответ на редактирование текста


    
    управление (_: textShouldBeginEditing:)
    - control:textShouldBeginEditing:

Вызванный, когда пользователь пытается ввести символ в ячейку управления, позволяющего редактировать текста (такого как текстовое поле или поле формы).

Объявление

Swift

optional func control(_ control: NSControl, textShouldBeginEditing fieldEditor: NSText) -> Bool

Objective C

- (BOOL)control:(NSControl *)control textShouldBeginEditing:(NSText *)fieldEditor

Параметры

`control`	Управление, содержание которого собирается быть отредактированным.
`fieldEditor`	Полевой редактор управления.

Возвращаемое значение

YEStrue если полевому редактору управления нужно разрешить начать редактировать текст; иначе, NOfalse.

Обсуждение

Можно использовать этот метод, чтобы позволить или запретить редактирование в управлении. Это сообщение отправляется управлением непосредственно к его объекту делегата.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.

Доступный как часть неофициального протокола до OS X v10.6.


    
    управление (_: textShouldEndEditing:)
    - control:textShouldEndEditing:

Вызванный, когда точка вставки пытается оставить ячейку отредактированного управления.

Объявление

Swift

optional func control(_ control: NSControl, textShouldEndEditing fieldEditor: NSText) -> Bool

Objective C

- (BOOL)control:(NSControl *)control textShouldEndEditing:(NSText *)fieldEditor

Параметры

`control`	Управление, для которого редактирование собирается закончиться.
`fieldEditor`	Полевой редактор управления. Можно использовать этот параметр для получения отредактированного текста.

Возвращаемое значение

YEStrue если точке вставки нужно позволить закончить сеанс редактирования; иначе, NOfalse.

Обсуждение

Это сообщение отправляется только средствами управления, позволяющими редактировать текста (такого как текстовое поле или поле формы). Это сообщение отправляется управлением непосредственно к его объекту делегата.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.

Доступный как часть неофициального протокола до OS X v10.6.

Работа с текстовым завершением


    
    управление (_: textView:completions:forPartialWordRange:indexOfSelectedItem:)
    - control:textView:completions:forPartialWordRange:indexOfSelectedItem:

Вызванный, чтобы позволить Вам управлять списком предложенных текстовых завершений, сгенерированных текстовыми полями и другими средствами управления.

Объявление

Swift

optional func control(_ control: NSControl, textView textView: NSTextView, completions words: [AnyObject], forPartialWordRange charRange: NSRange, indexOfSelectedItem index: UnsafeMutablePointer<Int>) -> [AnyObject]

Objective C

- (NSArray *)control:(NSControl *)control textView:(NSTextView *)textView completions:(NSArray *)words forPartialWordRange:(NSRange)charRange indexOfSelectedItem:(NSInteger *)index

Параметры

`control`	Управление, ячейка которого инициировала сообщение. Если управление содержит многократные ячейки, тот, инициировавший сообщение, обычно является выбранной ячейкой.
`textView`	Полевой редактор управления. Можно использовать этот параметр для получения напечатанного текста.
`words`	Массив `NSString` объекты, содержащие потенциальные завершения. Строки завершения перечислены в их порядке предпочтения в массиве.
`charRange`	Диапазон символов пользователь уже ввел.
`index`	На вводе, целочисленной переменной со значением по умолчанию `0`. На выводе можно установить это значение в индекс в возвращенном массиве, указывающем, какой элемент должен быть выбран первоначально. Установите значение в `-1` для указания не должно быть начального выбора.

Возвращаемое значение

Массив NSString объекты, содержащие список завершений для использования вместо массива в words параметр. Возвращенный массив должен перечислить завершения в их предпочтительном порядке

Обсуждение

Каждая строка, которую Вы возвращаете, должна быть полным словом, которое пользователь мог бы пытаться ввести. Строки должны быть полными словами, а не просто остатком от слова, в случае, если завершение требует некоторой небольшой модификации того, что пользователь уже ввел — например, добавление диакритического знака или изменение в капитализации. Можно также использовать этот метод для поддержки сокращений, завершающихся в слова, не запускающиеся с символов сокращения. index параметр позволяет Вам возвращать ссылкой индекс, указывающий, какое из завершений должно быть выбрано первоначально.

Фактические средние значения представления потенциальных завершений определяются complete: метод NSTextView.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.3 и позже.

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– complete: (NSTextView)

Работа с привязками клавиш


    
    управление (_: textView:doCommandBySelector:)
    - control:textView:doCommandBySelector:

Вызванный, когда пользователи нажимают клавиши с предопределенной привязкой в ячейке указанного управления.

Объявление

Swift

optional func control(_ control: NSControl, textView textView: NSTextView, doCommandBySelector command: Selector) -> Bool

Objective C

- (BOOL)control:(NSControl *)control textView:(NSTextView *)textView doCommandBySelector:(SEL)command

Параметры

`control`	Управление, ячейка которого инициировала сообщение. Если управление содержит многократные ячейки, тот, инициировавший сообщение, обычно является выбранной ячейкой.
`textView`	Полевой редактор управления.
`command`	Селектор, связанный с привязкой.

Возвращаемое значение

YEStrue если объект делегата обрабатывает привязку клавиш; иначе, NOfalse.

Обсуждение

Эта привязка обычно реализуется как методы (command) определенный в NSResponder класс; примерами таких привязок клавиш являются клавиши со стрелками (для направленного перемещения) и Клавиша выхода (для завершения имени). Путем реализации этого метода делегат может переопределить реализацию по умолчанию command и предоставьте его собственное поведение.

Например, метод по умолчанию для завершения частично введенных путей или символов (обычно, когда пользователи нажимают Клавишу выхода) complete:. Реализация по умолчанию complete: метод (в NSResponder) ничего не делает. Делегат мог оценить метод в command параметр и, если это complete:, получите текущую строку от textView параметр и затем разворачивает его, или выводит на экран список потенциальных завершений или делает то, что является надлежащим.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.

Доступный как часть неофициального протокола до OS X v10.6.