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

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

Разработчик

Ссылка платформы PreferencePanes ссылка класса NSPreferencePane

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

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

NSPreferencePane

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

Предпочтительные области являются подклассами NSPreferencePane, упакованный в пакетах и загруженный предпочтительным приложением, таких как Установки системы. Эти пакеты имеют суффикс .prefPane. Пакеты, предназначенные для использования Установками системы, расположены в Library/PreferencePanes каталоги различных доменов файловой системы. Посмотрите Домены Файловой системы главы в Обзоре Файловой системы для получения информации о доменах.

Предпочтительный пакет области обычно содержит файл пера с пользовательским интерфейсом для изменения пользовательских настроек. Файл пера содержит окно, присвоенное _window выходу предпочтительного экземпляра области (Владелец Файла пера). Реализация NSPreferencePane loadMainView, вызванный предпочтительным приложением, загружает файл пера и использует представление содержания _window как основное представление области предпочтения. Переопределите этот метод при необходимости в различном методе для создания пользовательского интерфейса.

NSPreferencePane подкласс ответственен за инициализацию пользовательского интерфейса с текущими предпочтительными настройками и записью любых модификаций, которые делает пользователь. Через серию will..., did..., и should... когда область выбрана (выведенная на экран) и невыбранная, позволив области выполнить необходимые действия в подходящее время, методы, предпочтительное приложение уведомляет предпочтительную область. Реализуйте эти методы (и любые дополнительные целевые методы действия, подключенные к интерфейсу) по мере необходимости для создания желаемого поведения для предпочтительной области.

Предпочтительные области поддерживают элементы Меню справки. Вы указываете статические элементы меню справки под NSPrefPaneHelpAnchors в пакете Info.plist файл; для динамических элементов Вы реализуете updateHelpMenuWithArray:.

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

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

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

Swift

import PreferencePanes

Objective C

@import PreferencePanes;

Доступность

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

Инициализация предпочтительной области
  • init (пакет:) - initWithBundle:

    Инициализирует получатель с предпочтительным пакетом области, возвращаясь self.

    Объявление

    Swift

    init!(bundle bundle: NSBundle!)

    Objective C

    - (instancetype)initWithBundle:(NSBundle *)bundle

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

    Objective C

    @import PreferencePanes;

    Swift

    import PreferencePanes

    Доступность

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

Получение предпочтения разделяет пакет на области
  • пакет пакет Свойство

    Предпочтительный пакет области. (только для чтения)

    Объявление

    Swift

    var bundle: NSBundle! { get }

    Objective C

    @property(readonly, strong) NSBundle *bundle

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

    Objective C

    @import PreferencePanes;

    Swift

    import PreferencePanes

    Доступность

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

Установка основного представления
  • assignMainView () - assignMainView

    Определяет местоположение и присваивает основное представление получателя от файла пера, загруженного loadMainView.

    Объявление

    Swift

    func assignMainView()

    Objective C

    - (void)assignMainView

    Обсуждение

    Реализация по умолчанию устанавливает основное представление получателя в представление содержания окна, на которое ссылаются _window выход. Перед возвратом, assignMainView выпускает окно и устанавливает _window выход к nil. Возвращает основное представление в случае успеха, nil иначе.

    Переопределите этот метод, если Ваше основное представление расположено в файле пера, загруженном loadMainView, но не представление содержания окна в файле. Вызвать setMainView: установить основное представление предпочтительной области перед возвратом. Также вызовите setInitialKeyView:, setFirstKeyView:, и setLastKeyView: установить начальную букву, во-первых, и продлиться представления клавиатурного фокуса, соответственно.

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

    Objective C

    @import PreferencePanes;

    Swift

    import PreferencePanes

    Доступность

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

  • loadMainView () - loadMainView

    Загружает пользовательский интерфейс получателя в его основное представление.

    Объявление

    Swift

    func loadMainView() -> NSView!

    Objective C

    - (NSView *)loadMainView

    Обсуждение

    Реализация по умолчанию загружает основной файл пера (идентифицированный mainNibName) и вызывает assignMainView установить основное представление предпочтительной области. Возвращает основное представление в случае успеха, nil иначе.

    Подклассы должны редко должны быть переопределить этот метод. Переопределите этот метод, если необходимо использовать базируемый метод непера для создания основного представления. Вызвать setMainView: установить основное представление предпочтительной области перед возвратом. Также вызовите setInitialKeyView:, setFirstKeyView:, и setLastKeyView: установить начальную букву, во-первых, и продлиться представления клавиатурного фокуса, соответственно.

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

    Objective C

    @import PreferencePanes;

    Swift

    import PreferencePanes

    Доступность

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

    См. также

    – mainViewDidLoad

  • mainNibName mainNibName Свойство

    Имя предпочтительного файла пера области. (только для чтения)

    Объявление

    Swift

    var mainNibName: String! { get }

    Objective C

    @property(readonly, strong) NSString *mainNibName

    Обсуждение

    Имя не должно включать .nib расширение.

    Реализация по умолчанию возвращает значение NSMainNibFile введите информационный список свойств пакета. Если ключ не существует, он возвращает значение по умолчанию @”Main”.

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

    Objective C

    @import PreferencePanes;

    Swift

    import PreferencePanes

    Доступность

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

    См. также

    – loadMainView

  • mainView mainView Свойство

    Основное представление предпочтительной области.

    Объявление

    Swift

    var mainView: NSView!

    Objective C

    @property(strong) NSView *mainView

    Обсуждение

    Подклассы не должны должны быть переопределять это, если они не переопределяют loadMainView или assignMainView.

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

    Objective C

    @import PreferencePanes;

    Swift

    import PreferencePanes

    Доступность

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

  • mainViewDidLoad () - mainViewDidLoad

    Уведомляет получатель, что основное представление установлено и подготовлено быть выведенным на экран.

    Объявление

    Swift

    func mainViewDidLoad()

    Objective C

    - (void)mainViewDidLoad

    Обсуждение

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

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

    Objective C

    @import PreferencePanes;

    Swift

    import PreferencePanes

    Доступность

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

Обработка клавиатурного фокуса
  • firstKeyView firstKeyView Свойство

    Первое представление в цепочке клавиатурного фокуса.

    Объявление

    Swift

    var firstKeyView: NSView!

    Objective C

    @property(strong) NSView *firstKeyView

    Обсуждение

    Первое ключевое представление может быть установлено в файле пера путем соединения представления с получателем _firstKeyView выход.

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

    Objective C

    @import PreferencePanes;

    Swift

    import PreferencePanes

    Доступность

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

  • initialKeyView initialKeyView Свойство

    Представление, которое должно иметь клавиатурный фокус, когда выбрана область.

    Объявление

    Swift

    var initialKeyView: NSView!

    Objective C

    @property(strong) NSView *initialKeyView

    Обсуждение

    Начальное представление может быть установлено в файле пера путем соединения представления с получателем _initialKeyView выход.

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

    Objective C

    @import PreferencePanes;

    Swift

    import PreferencePanes

    Доступность

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

  • lastKeyView - lastKeyView

    Последнее представление в цепочке клавиатурного фокуса.

    Объявление

    Swift

    var lastKeyView: NSView!

    Objective C

    @property(strong) NSView *lastKeyView

    Обсуждение

    Последнее представление может быть установлено в файле пера путем соединения представления с получателем _lastKeyView выход.

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

    Objective C

    @import PreferencePanes;

    Swift

    import PreferencePanes

    Доступность

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

  • autoSaveTextFields autoSaveTextFields Свойство

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

    Объявление

    Swift

    var autoSaveTextFields: Bool { get }

    Objective C

    @property(readonly) BOOL autoSaveTextFields

    Обсуждение

    Если это свойство YEStrue, текстовые поля вынуждены бросить свое состояние респондента прежде shouldUnselect вызывается на предпочтительной области. Если это NOfalse, предпочтительная область ответственна за то, чтобы вынуждать текстовые поля бросить их состояние респондента прежде, чем сохранить их. Значение по умолчанию YEStrue.

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

    Objective C

    @import PreferencePanes;

    Swift

    import PreferencePanes

    Доступность

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

Обработка предпочтения разделяет выбор на области
  • выбранный выбранный Свойство

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

    Объявление

    Swift

    var selected: Bool { get }

    Objective C

    @property(getter=isSelected, readonly) BOOL selected

    Обсуждение

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

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

    Objective C

    @import PreferencePanes;

    Swift

    import PreferencePanes

    Доступность

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

  • didSelect () - didSelect

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

    Объявление

    Swift

    func didSelect()

    Objective C

    - (void)didSelect

    Обсуждение

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

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

    Objective C

    @import PreferencePanes;

    Swift

    import PreferencePanes

    Доступность

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

    См. также

    – willSelect

  • willSelect () - willSelect

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

    Объявление

    Swift

    func willSelect()

    Objective C

    - (void)willSelect

    Обсуждение

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

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

    Objective C

    @import PreferencePanes;

    Swift

    import PreferencePanes

    Доступность

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

    См. также

    – didSelect

  • didUnselect () - didUnselect

    Уведомляет получатель, что главное приложение только что прекратило отображать основное представление области предпочтения.

    Объявление

    Swift

    func didUnselect()

    Objective C

    - (void)didUnselect

    Обсуждение

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

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

    Objective C

    @import PreferencePanes;

    Swift

    import PreferencePanes

    Доступность

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

    См. также

    – willUnselect

  • replyToShouldUnselect (_:) - replyToShouldUnselect:

    Уведомляет главное приложение готовности получателя (или нежелание) для отмены выбора.

    Объявление

    Swift

    func replyToShouldUnselect(_ shouldUnselect: Bool)

    Objective C

    - (void)replyToShouldUnselect:(BOOL)shouldUnselect

    Обсуждение

    Если Вы переопределяете shouldUnselect возвратиться NSUnselectLater, необходимо вызвать replyToShouldUnselect: когда Вы определили, может ли быть невыбранной предпочтительная область.

    Вы не должны переопределять этот метод.

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

    Objective C

    @import PreferencePanes;

    Swift

    import PreferencePanes

    Доступность

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

  • shouldUnselect shouldUnselect Свойство

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

    Объявление

    Swift

    var shouldUnselect: NSPreferencePaneUnselectReply { get }

    Objective C

    @property(readonly) NSPreferencePaneUnselectReply shouldUnselect

    Обсуждение

    Возможные значения описаны в Константах. Реализация по умолчанию всегда возвращается NSUnselectNow. Переопределите этот метод, если Ваша область должна отменить или задержать действие отмены выбора. Если Вы переопределяете этот метод для возврата NSUnselectLater, необходимо вызвать replyToShouldUnselect: когда Вы определили, может ли произойти отмена выбора.

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

    Objective C

    @import PreferencePanes;

    Swift

    import PreferencePanes

    Доступность

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

  • willUnselect () - willUnselect

    Уведомляет получатель, что главное приложение собирается прекратить отображать основное представление области предпочтения.

    Объявление

    Swift

    func willUnselect()

    Objective C

    - (void)willUnselect

    Обсуждение

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

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

    Objective C

    @import PreferencePanes;

    Swift

    import PreferencePanes

    Доступность

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

    См. также

    – didUnselect

Поддержка Меню справки
  • updateHelpMenuWithArray (_:) - updateHelpMenuWithArray:

    Обновляет меню справки.

    Объявление

    Swift

    func updateHelpMenuWithArray(_ inArrayOfMenuItems: [AnyObject]!)

    Objective C

    - (void)updateHelpMenuWithArray:(NSArray *)inArrayOfMenuItems

    Обсуждение

    Вызовите этот метод, если необходимо обновить элементы меню справки динамично. Если у Вас есть статические элементы меню справки, Вы не должны использовать этот метод. Укажите их под NSPrefPanelHelpAnchors введите пакет Info.plist вместо этого.

    Массив содержит словари с двумя ключами. Использовать title для заголовка элемента меню справки, и anchor для ссылки привязки для AHLookupAnchor.

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

    Objective C

    @import PreferencePanes;

    Swift

    import PreferencePanes

    Доступность

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

Уведомления
  • NSPreferencePaneDoUnselectNotification NSPreferencePaneDoUnselectNotification

    Уведомляет главное приложение, что предпочтительная область готова быть невыбранной. Отправленный, когда replyToShouldUnselect: вызывается с параметром YEStrue после shouldUnselect возвратил значение NSUnselectLater.

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

    Objective C

    @import PreferencePanes;

    Swift

    import PreferencePanes

    Доступность

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

  • NSPreferencePaneCancelUnselectNotification NSPreferencePaneCancelUnselectNotification

    Уведомляет главное приложение, что предпочтительная область не готова быть невыбранной. Отправленный, когда replyToShouldUnselect: вызывается с параметром NOfalse после shouldUnselect возвратил значение NSUnselectLater.

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

    Objective C

    @import PreferencePanes;

    Swift

    import PreferencePanes

    Доступность

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