SFAuthorizationPluginView

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

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

Инстанцировать Вашего SFAuthorizationPluginView подкласс, Вам нужна структура обратных вызовов, содержащая точки входа к Серверу безопасности, который Вы получаете в своем плагине AuthorizationPluginCreate функционируйте и дескриптор механизма авторизации, который Вы получаете в своем плагине MechanismCreate функция.

Ваш пользовательский подкласс SFAuthorizationPluginView должен переопределить следующие методы:

buttonPressed:
viewForType:

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

NSObject
SFAuthorizationPluginView

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

NSObject

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

Не применимый

Objective C

@import SecurityInterface;

Доступность

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

Инициализация объекта SFAuthorizationPluginView


    
    initWithCallbacks:andEngineRef:
    - initWithCallbacks:andEngineRef:

Возвраты SFAuthorizationPluginView объект с указанными обратными вызовами и дескриптором механизма авторизации.

Объявление

Objective C

- (id)initWithCallbacks:(const AuthorizationCallbacks *)callbacks andEngineRef:(AuthorizationEngineRef)engineRef

Параметры

`callbacks`	Структура типа `AuthorizationCallbacks` если к плагину авторизации в `AuthorizationPluginCreate` функция.
`engineRef`	Дескриптор типа `AuthorizationEngineRef` если к плагину авторизации в `MechanismCreate` функция.

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

Инициализированный SFAuthorizationPluginView экземпляр.

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

Objective C

@import SecurityInterface;

Доступность

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

Получение информации экземпляра

обратные вызовы - обратные вызовы

Возвраты AuthorizationCallbacks структура, с которой был инициализирован этот экземпляр.

Объявление

Objective C

- (const AuthorizationCallbacks *)callbacks

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

Объект типа AuthorizationCallbacks.

Обсуждение

Используйте AuthorizationCallbacks структура для получения указателей функции к функциям такой как SetResult и SetContextValue.

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

Objective C

@import SecurityInterface;

Доступность

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

Возвращает дескриптор механизма авторизации, с которым был инициализирован этот экземпляр.

Объявление

Objective C

- (AuthorizationEngineRef)engineRef

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

Дескриптор типа AuthorizationEngineRef.

Обсуждение

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

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

Objective C

@import SecurityInterface;

Доступность

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

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

Объявление

Objective C

- (NSError *)lastError

Обсуждение

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

Нисходящий плагин может установить значение контекста с помощью kAuthorizationContextFlagSticky флаг для предоставления доступа к нему доступным для SFAuthorizationPluginView класс в случае ошибки.

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

Objective C

@import SecurityInterface;

Доступность

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

Ответ на пользовательские действия

buttonPressed: - buttonPressed:

Сообщает SFAuthorizationPluginView экземпляр, когда пользователь нажимает кнопку в пользовательском представлении.

Объявление

Objective C

- (void)buttonPressed:(SFButtonType)inButtonType

Параметры

inButtonType

Тип нажатой кнопки.

Обсуждение

По умолчанию, buttonPressed: установит результат, Отклоняют, когда нажимаются кнопки OK или Login. SFAuthorizationPluginView разделите на подклассы должен переопределить этот метод для установки значений контекста для краткого названия пользователя так, чтобы могли искаться пользовательские атрибуты. Чтобы сделать это, использовать kAuthorizationEnvironmentUsername как ключ. Подкласс должен также установить любые дополнительные значения контекста, которые необходимы плагину авторизации для проверки учетных данных пользователя. Чтобы сделать это, используйте надлежащие указатели функции, из которых Вы получаете callbacks.

При переопределении этого метода не вызывать [super buttonPressed].

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

Objective C

@import SecurityInterface;

Доступность

Доступный в OS X v10.5 и позже.
viewForType: - viewForType:

Возвращает надлежащее NSView объект для указанного SFViewType.

Объявление

Objective C

- (NSView *)viewForType:(SFViewType)inType

Параметры

inType

Тип представления, требуемого плагином авторизации.

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

NSView объект, представляющий или представление учетных данных или идентификационные данные и представление учетных данных.

Обсуждение

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

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

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

Objective C

@import SecurityInterface;

Доступность

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

Конфигурирование пользовательского интерфейса

didActivate - didActivate

Сообщает SFAuthorizationPluginView экземпляр, когда плагин авторизации делает пользовательский интерфейс экземпляра активным.

Объявление

Objective C

- (void)didActivate

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

Objective C

@import SecurityInterface;

Доступность

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

Сообщает SFAuthorizationPluginView экземпляр, когда плагин авторизации деактивировал свой пользовательский интерфейс.

Объявление

Objective C

- (void)didDeactivate

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

Objective C

@import SecurityInterface;

Доступность

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


    
    willActivateWithUser:
    - willActivateWithUser:

Сообщает SFAuthorizationPluginView экземпляр, когда его пользовательский интерфейс собирается быть сделанным активным предоставленным Apple Агентом безопасности.

Объявление

Objective C

- (void)willActivateWithUser:(NSDictionary *)inUserInformation

Параметры


      inUserInformation

Словарь, содержащий следующую информацию:

kSFAuthorizationPluginViewUserNameKey

NSString объект, содержащий имя выбранного пользователя
kSFAuthorizationPluginViewUserShortNameKey

NSString объект, содержащий краткое название выбранного пользователя

Примечание: inUserInformation может быть nil.

Обсуждение

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

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

Objective C

@import SecurityInterface;

Доступность

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

Установка цикла клавиатуры

firstKeyView - firstKeyView

Возвращает первое представление в цикле клавиатуры представления.

Объявление

Objective C

- (NSView *)firstKeyView

Обсуждение

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

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

Objective C

@import SecurityInterface;

Доступность

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

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

Объявление

Objective C

- (NSResponder *)firstResponder

Обсуждение

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

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

Objective C

@import SecurityInterface;

Доступность

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

Возвращает последнее представление в цикле клавиатуры представления.

Объявление

Objective C

- (NSView *)lastKeyView

Обсуждение

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

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

Objective C

@import SecurityInterface;

Доступность

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

Включение и отключение средств управления

setEnabled: - setEnabled:

Включает или отключает средства управления в SFAuthorizationPluginView представление экземпляра.

Объявление

Objective C

- (void)setEnabled:(BOOL)inEnabled

Параметры

inEnabled

Состояние средства управления должно быть в.

Обсуждение

Когда плагин авторизации вызывает этот метод, подкласс должен вызвать setEnabled: на средствах управления, которые находятся в его представлении.

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

Objective C

@import SecurityInterface;

Доступность

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

Связь с плагином авторизации

displayView - displayView

Выводит на экран пользовательский интерфейс, предоставленный SFAuthorizationPluginView подкласс.

Объявление

Objective C

- (void)displayView

Обсуждение

Маловероятно, что Вы захотите переопределить этот метод, но если Вы делаете, убедиться вызвать [super displayView]. Если Вы не вызываете [super displayView], Ваше пользовательское представление не будет выведено на экран.

Этот метод повысит SFDisplayViewException исключение, если ошибка происходит при отображении диалогового окна авторизации.

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

Objective C

@import SecurityInterface;

Доступность

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


    
    setButton:enabled:
    - setButton:enabled:

Включает или отключает кнопку в SFAuthorizationPluginView пользовательский интерфейс экземпляра.

Объявление

Objective C

- (void)setButton:(SFButtonType)inButtonType enabled:(BOOL)inEnabled

Параметры

`inButtonType`	Тип кнопки.
`inEnabled`	`YEStrue` включить кнопку, `NOfalse` отключить кнопку.

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

Objective C

@import SecurityInterface;

Доступность

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

updateView - updateView

Говорит плагину авторизации получать и отображать надлежащее представление в SFAuthorizationPluginView пользовательский интерфейс экземпляра.

Объявление

Objective C

- (void)updateView

Обсуждение

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

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

Objective C

@import SecurityInterface;

Доступность

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

Константы

SFButtonType
Эти константы определяют типы кнопки, используемые плагинами авторизации.

Объявление

Objective C

typedef enum{ SFButtonTypeCancel = NSCancelButton, SFButtonTypeOK = NSOKButton, SFButtonTypeBack = SFButtonTypeCancel, SFButtonTypeLogin = SFButtonTypeOK } SFButtonType;

Константы
- SFButtonTypeCancel
  
  SFButtonTypeCancel
  
  Указывает, что была нажата Кнопка отмены.
  
  Доступный в OS X v10.5 и позже.
- SFButtonTypeOK
  
  SFButtonTypeOK
  
  Указывает, что была нажата кнопка OK.
  
  Доступный в OS X v10.5 и позже.
- SFButtonTypeBack
  
  SFButtonTypeBack
  
  Указывает, что была нажата Кнопка «Назад».
  
  Доступный в OS X v10.5 и позже.
- SFButtonTypeLogin
  
  SFButtonTypeLogin
  
  Указывает, что была нажата кнопка Login.
  
  Доступный в OS X v10.5 и позже.
Оператор импорта

Objective C

@import SecurityInterface;

Доступность

Доступный в OS X v10.5 и позже.
SFViewType
Эти константы определяют тип представления, который требует плагин авторизации.

Объявление

Objective C

typedef enum { SFViewTypeIdentityAndCredentials, SFViewTypeCredentials } SFViewType;

Константы
- SFViewTypeIdentityAndCredentials
  
  SFViewTypeIdentityAndCredentials
  
  Указывает представление, содержащее средства управления для идентификационных данных, и учетные данные требовал плагин авторизации.
  
  Доступный в OS X v10.5 и позже.
- SFViewTypeCredentials
  
  SFViewTypeCredentials
  
  Указывает представление, содержащее средства управления для учетных данных, требовался плагином авторизации.
  
  Доступный в OS X v10.5 и позже.
Оператор импорта

Objective C

@import SecurityInterface;

Доступность

Доступный в OS X v10.5 и позже.
Исключения
Исключения, выданные SFAuthorizationPluginView класс

Объявление

Objective C

extern NSString * const SFDisplayViewException;

Константы
- SFDisplayViewException
  
  SFDisplayViewException
  
  Повышенный, когда ошибка происходит в отображении диалогового окна авторизации.
  
  Доступный в OS X v10.5 и позже.