Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка платформы AppKit ссылка класса NSSearchFieldCell

Опции
Развертывание Target:

На этой странице
Язык:

NSSearchFieldCell

NSSearchFieldCell класс определяет программируемый интерфейс для текстовых полей, оптимизированных для основанных на тексте поисков. NSSearchFieldCell объект «обертывается» объектом управления NSSearchField, непосредственно наследовавшимся от NSTextField класс. Поле поиска, реализованное этими классами, представляет стандартный пользовательский интерфейс для поисков, включая кнопку поиска, кнопку отмены и раскрывающееся меню значка для перечисления недавних строк поиска и пользовательских поисковых категорий.

Когда пользователь вводит и затем паузы, сообщение действия ячейки отправляется в его цель. Можно запросить строковое значение ячейки для текущего текста для поиска. Не полагайтесь на отправителя действия, чтобы быть NSMenu возразите, потому что может измениться меню. Если необходимо изменить меню, изменить поисковый шаблон меню и обновить значение в searchMenuTemplate свойство.

Наследование

Соответствует

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Управление кнопками
  • searchButtonCell searchButtonCell Свойство

    Ячейка кнопки раньше выводила на экран изображение кнопки поиска.

    Объявление

    Swift

    var searchButtonCell: NSButtonCell?

    Objective C

    @property(strong) NSButtonCell *searchButtonCell

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – resetSearchButtonCell

  • resetSearchButtonCell () - resetSearchButtonCell

    Сбрасывает ячейку кнопки поиска к ее атрибутам по умолчанию.

    Объявление

    Swift

    func resetSearchButtonCell()

    Objective C

    - (void)resetSearchButtonCell

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    searchButtonCell

  • cancelButtonCell cancelButtonCell Свойство

    Ячейка кнопки раньше выводила на экран изображение кнопки отмены.

    Объявление

    Swift

    var cancelButtonCell: NSButtonCell?

    Objective C

    @property(strong) NSButtonCell *cancelButtonCell

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – resetCancelButtonCell

  • resetCancelButtonCell () - resetCancelButtonCell

    Сбрасывает ячейку кнопки отмены к ее атрибутам по умолчанию.

    Объявление

    Swift

    func resetCancelButtonCell()

    Objective C

    - (void)resetCancelButtonCell

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    cancelButtonCell

Пользовательский макет
  • searchTextRectForBounds (_:) - searchTextRectForBounds:

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

    Объявление

    Swift

    func searchTextRectForBounds(_ rect: NSRect) -> NSRect

    Objective C

    - (NSRect)searchTextRectForBounds:(NSRect)rect

    Параметры

    rect

    Текущий ограничительный прямоугольник для поля искомого текста.

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

    Обновленный ограничительный прямоугольник для использования для поля искомого текста. Значение по умолчанию является значением, переданным в rect параметр.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – cancelButtonRectForBounds:
    – searchButtonRectForBounds:

  • searchButtonRectForBounds (_:) - searchButtonRectForBounds:

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

    Объявление

    Swift

    func searchButtonRectForBounds(_ rect: NSRect) -> NSRect

    Objective C

    - (NSRect)searchButtonRectForBounds:(NSRect)rect

    Параметры

    rect

    Текущий ограничительный прямоугольник для кнопки поиска.

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

    Обновленный ограничительный прямоугольник для использования для кнопки поиска. Значение по умолчанию является значением, переданным в rect параметр.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – cancelButtonRectForBounds:
    – searchTextRectForBounds:

  • cancelButtonRectForBounds (_:) - cancelButtonRectForBounds:

    Изменяет ограничительный прямоугольник для ячейки кнопки отмены.

    Объявление

    Swift

    func cancelButtonRectForBounds(_ rect: NSRect) -> NSRect

    Objective C

    - (NSRect)cancelButtonRectForBounds:(NSRect)rect

    Параметры

    rect

    Текущий ограничительный прямоугольник для кнопки отмены.

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

    Обновленный ограничительный прямоугольник для использования для кнопки отмены. Значение по умолчанию является значением, переданным в rect параметр.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – searchButtonRectForBounds:
    – searchTextRectForBounds:

Управление шаблонами меню
  • searchMenuTemplate searchMenuTemplate Свойство

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

    Объявление

    Swift

    var searchMenuTemplate: NSMenu?

    Objective C

    @property(strong) NSMenu *searchMenuTemplate

    Обсуждение

    Ячейка ищет константы тега, описанные в Menu tags определить, как заполнить меню с элементами, имело отношение к недавним поискам. Для примера того, как Вы могли бы установить поисковый шаблон меню, посмотрите Конфигурирование Поискового Меню.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Управление режимами поиска
  • sendsWholeSearchString sendsWholeSearchString Свойство

    Булево значение, указывающее, вызывает ли ячейка свой поисковый метод действия, когда пользователь щелкает по кнопке поиска (или нажимает Return), или после каждого нажатия клавиши.

    Объявление

    Swift

    var sendsWholeSearchString: Bool

    Objective C

    @property BOOL sendsWholeSearchString

    Обсуждение

    Когда значение этого свойства YEStrue, когда пользователь щелкает по кнопке поиска или нажимает Return, ячейка вызывает свой метод действия. Когда значение NOfalse, ячейка вызывает метод действия после каждого нажатия клавиши. Значение по умолчанию этого свойства NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • sendsSearchStringImmediately sendsSearchStringImmediately Свойство

    Булево значение, указывающее, вызывает ли ячейка свой метод действия сразу, когда происходят соответствующие меры.

    Объявление

    Swift

    var sendsSearchStringImmediately: Bool

    Objective C

    @property BOOL sendsSearchStringImmediately

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Управление недавними строками поиска
  • maximumRecents maximumRecents Свойство

    Максимальное количество строк поиска, которые могут появиться в поисковом меню.

    Объявление

    Swift

    var maximumRecents: Int

    Objective C

    @property NSInteger maximumRecents

    Обсуждение

    Значение этого свойства должно быть между 0 и 254. Указание отрицательной величины для наборов свойств это к значению по умолчанию, которое является 10. Указание значения, больше, чем 254 устанавливает свойство в 254.

    Когда максимальное количество строк поиска превышено, самая старая строка поиска в меню отбрасывается.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • recentSearches recentSearches Свойство

    Массив недавних строк поиска для отображения в раскрывающемся меню значка поля поиска.

    Объявление

    Swift

    var recentSearches: [AnyObject]!

    Objective C

    @property(copy) NSArray *recentSearches

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    recentsAutosaveName

  • recentsAutosaveName recentsAutosaveName Свойство

    Имя автосохранения, под которым поле поиска автоматически сохраняет список недавних строк поиска.

    Объявление

    Swift

    var recentsAutosaveName: String?

    Objective C

    @property(copy) NSString *recentsAutosaveName

    Обсуждение

    Имя автосохранения используется в качестве ключа в стандартных пользовательских значениях по умолчанию для сохранения недавних поисков. Если Вы указываете nil или пустая строка для этого параметра, никакое имя автосохранения не определяется, и поиски автоматически не сохранены.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    recentSearches

Константы
  • Теги меню

    Константы для идентификации специальных пунктов меню в шаблоне поискового меню.

    Объявление

    Swift

    var NSSearchFieldRecentsTitleMenuItemTag: Int32 { get } var NSSearchFieldRecentsMenuItemTag: Int32 { get } var NSSearchFieldClearRecentsMenuItemTag: Int32 { get } var NSSearchFieldNoRecentsMenuItemTag: Int32 { get }

    Objective C

    #define NSSearchFieldRecentsTitleMenuItemTag 1000 #define NSSearchFieldRecentsMenuItemTag 1001 #define NSSearchFieldClearRecentsMenuItemTag 1002 #define NSSearchFieldNoRecentsMenuItemTag 1003

    Константы

    • NSSearchFieldRecentsTitleMenuItemTag

      NSSearchFieldRecentsTitleMenuItemTag

      Идентифицирует пункт меню, который является заголовком группы меню для недавних строк поиска.

      Если нет никаких недавних строк, этот элемент скрыт.

      Можно использовать этот маркированный элемент для символов разделителя, также не появляющихся, при отсутствии недавних строк для отображения.

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

    • NSSearchFieldRecentsMenuItemTag

      NSSearchFieldRecentsMenuItemTag

      Идентифицирует, где недавние строки поиска должны появиться в «recents» группе меню.

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

    • NSSearchFieldClearRecentsMenuItemTag

      NSSearchFieldClearRecentsMenuItemTag

      Идентифицирует пункт меню для очистки текущего набора недавних поисков строки в меню.

      Если нет никаких недавних строк, этот элемент скрыт.

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

    • NSSearchFieldNoRecentsMenuItemTag

      NSSearchFieldNoRecentsMenuItemTag

      Идентифицирует пункт меню, описывающий отсутствие недавних строк поиска (например, “Никакие недавние поиски”).

      Если были недавние поиски, этот элемент скрыт.

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

    Обсуждение

    Когда NSSearchFieldCell возразите динамично создает фактическое поисковое меню из этого шаблона, оно показывает или скрывает маркированные элементы, как направлено.

    Доступность

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