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

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

Разработчик

Ссылка платформы SecurityInterface ссылка класса SFAuthorizationView

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

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

SFAuthorizationView

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

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

Представление рисунка 1Authorization блокирует значок image: ../Art/authview.eps

Когда Вы добавляете представление авторизации как пользовательское представление к окну или диалоговому окну, необходимо инициализировать его, прежде чем это выведет на экран правильно. Для инициализации представления используйте setString: метод для создания структуры прав по умолчанию (содержащий строку приглашения) или setAuthorizationRights: метод для указания структуры прав. Необходимо также или указать автоматические обновления (setAutoupdate: или setAutoupdate:interval:) или выполните ручное обновление (updateStatus:) установить значок блокировки в его начальное состояние.

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

Когда пользователь щелкает по заблокированному значку представления авторизации, Сервер безопасности выводит на экран диалог аутентификации (для запроса имени пользователя и пароля, например). Когда пользователь обеспечивает требуемые учетные данные, значок блокировки разблокировал, и пользователя считают предавторизованным выполнить функции, указанные структурой прав авторизации. Можно вызвать updateStatus: метод, чтобы определить, был ли пользователь предварительно авторизован: этот метод возвраты YEStrue если представление находится в разблокированном состоянии, NOfalse иначе. Прежде, чем фиксировать изменения или выполнить действия, требующие авторизации, необходимо проверить авторизацию пользователя снова, даже если они предварительно авторизовываются.

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

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

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

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

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

Objective C

@import SecurityInterface;

Доступность

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

Установка представления авторизации
  • setString: - setString:

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

    Объявление

    Objective C

    - (void)setString:(AuthorizationString)authorizationString

    Параметры

    authorizationString

    Строка, которая будет выведена на экран.

    Обсуждение

    Это - удобный метод, создающий набор прав авторизации, когда Вы указываете только имя требуемого права. Строка требуемого права выведена на экран в Панели диалогового окна аутентификации пользователя. Или этот метод или setAuthorizationRights: метод нужно вызвать перед дисплеями представления правильно.

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

    Objective C

    @import SecurityInterface;

    Доступность

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

    См. также

    – setAuthorizationRights:
    – authorizationRights

  • setAuthorizationRights: - setAuthorizationRights:

    Устанавливает права авторизации для этого представления.

    Объявление

    Objective C

    - (void)setAuthorizationRights:(const AuthorizationRights *)authorizationRights

    Параметры

    authorizationRights

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

    Обсуждение

    Или этот метод или setString: метод нужно вызвать перед дисплеями представления правильно.

    Структуры прав авторизации определяются в AuthorizationRights в службах авторизации C ссылка.

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

    Objective C

    @import SecurityInterface;

    Доступность

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

    См. также

    – authorizationRights
    – setString:

  • setAutoupdate: - setAutoupdate:

    Устанавливает представление авторизации для обновления себя автоматически.

    Объявление

    Objective C

    - (void)setAutoupdate:(BOOL)autoupdate

    Параметры

    autoupdate

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

    Обсуждение

    Если автоматические обновления включены, и авторизация испытывает таймаут (например), представление авторизации автоматически повторно блокирует. Если автоматические обновления отключены, необходимо вызвать updateStatus: метод для ручного обновления представления, если состояние изменяется, когда пользователь не щелкнул по значку блокировки. Автоматические обновления отключены по умолчанию. Поскольку автоматические обновления опрашивают, они могут влиять на производительность системы.

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

    Objective C

    @import SecurityInterface;

    Доступность

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

    См. также

    – setAutoupdate:interval:
    – updateStatus:

  • setAutoupdate:interval: - setAutoupdate:interval:

    Устанавливает представление авторизации для обновления себя в определенном интервале.

    Объявление

    Objective C

    - (void)setAutoupdate:(BOOL)autoupdate interval:(NSTimeInterval)interval

    Параметры

    autoupdate

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

    interval

    Если autoupdate YEStrue, устанавливает интервал, в котором обновления имеют место в секундах.

    Обсуждение

    Если автоматические обновления включены, и авторизация испытывает таймаут (например), представление авторизации автоматически повторно блокирует. Если автоматические обновления отключены, необходимо вызвать updateStatus: метод для ручного обновления представления, если состояние изменяется, когда пользователь не щелкнул по значку блокировки. Автоматические обновления отключены по умолчанию. Поскольку автоматические обновления опрашивают, они могут влиять на производительность системы. По этой причине Вы могли бы хотеть установить временной интервал так, чтобы опрос не имел место как часто.

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

    Objective C

    @import SecurityInterface;

    Доступность

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

    См. также

    – setAutoupdate:

  • setFlags: - setFlags:

    Устанавливает текущие флаги авторизации для представления.

    Объявление

    Objective C

    - (void)setFlags:(AuthorizationFlags)flags

    Параметры

    flags

    Авторизация отмечает для установки для этого представления.

    Обсуждение

    Можно использовать этот метод для изменения настроек флага авторизации, сделанных с setAuthorizationRights: метод или указать флаги кроме значения по умолчанию (kAuthorizationFlagDefaults) используемый setString: метод.

    Флаги авторизации описаны в Authorization Options в службах авторизации C ссылка.

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

    Objective C

    @import SecurityInterface;

    Доступность

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

    См. также

    – setAuthorizationRights:
    – setString:

  • setEnabled: - setEnabled:

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

    Объявление

    Objective C

    - (void)setEnabled:(BOOL)enabled

    Параметры

    enabled

    Указывает, должно ли представление авторизации быть включено (YEStrue) или отключенный (NOfalse).

    Обсуждение

    Отключенное представление видимо, но потускнело.

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

    Objective C

    @import SecurityInterface;

    Доступность

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

    См. также

    – authorizationState

Установка и получение делегата к представлению
  • setDelegate: - setDelegate:

    Устанавливает делегата к этому представлению авторизации.

    Объявление

    Objective C

    - (void)setDelegate:(id)delegate

    Параметры

    delegate

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

    Обсуждение

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

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

    Objective C

    @import SecurityInterface;

    Доступность

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

    См. также

    – delegate.

  • делегат - делегат

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

    Объявление

    Objective C

    - (id)delegate

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

    Objective C

    @import SecurityInterface;

    Доступность

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

    См. также

    – setDelegate:

Обновление представления
  • updateStatus: - updateStatus:

    Вручную обновляет представление авторизации.

    Объявление

    Objective C

    - (BOOL)updateStatus:(id)inSender

    Параметры

    inSender

    Представление авторизации для обновления.

    Обсуждение

    Вызовы к updateStatus: возвратиться YEStrue если в разблокированном состоянии, NOfalse иначе.

    Если автоматические обновления не были установлены, необходимо вызвать updateStatus для начального состояния представления авторизации для отображения правильно. Концепция безопасности вызывает этот метод для Вас при изменении состояния блокировки (путем вызова deauthorize:, например.

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

    Objective C

    @import SecurityInterface;

    Доступность

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

    См. также

    – setAutoupdate:
    – setAutoupdate:interval:.

Получение информации о представлении авторизации

Установка состояния авторизации
  • авторизуйте: - авторизуйте:

    Попытки разблокировать значок блокировки в представлении.

    Объявление

    Objective C

    - (BOOL)authorize:(id)inSender

    Параметры

    inSender

    Представление авторизации для разблокирования.

    Обсуждение

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

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

    Objective C

    @import SecurityInterface;

    Доступность

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

    См. также

    – deauthorize:
    – authorizationState

  • deauthorize: - deauthorize:

    Устанавливает состояние авторизации в несанкционированный и блокирует значок блокировки в представлении.

    Объявление

    Objective C

    - (BOOL)deauthorize:(id)inSender

    Параметры

    inSender

    Представление авторизации для блокировки.

    Обсуждение

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

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

    Objective C

    @import SecurityInterface;

    Доступность

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

    См. также

    – авторизуйте:

Методы делегата
  • authorizationViewShouldDeauthorize: authorizationViewShouldDeauthorize:

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

    Объявление

    Objective C

    - (BOOL)authorizationViewShouldDeauthorize:(SFAuthorizationView *)view

    Обсуждение

    Делегат может реагировать на это, прежде чем deauthorization произойдет, и избегите его путем возврата NOfalse. Когда Вы вызываете, этот метод делегата не вызывают deauthorize: метод.

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

    Objective C

    @import SecurityInterface;

    Доступность

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

    См. также

    – deauthorize:

  • authorizationViewCreatedAuthorization: authorizationViewCreatedAuthorization:

    Отправленный делегату для указания объекта авторизации был создан или изменен. При сохранении копии объекта авторизации в собственных целях необходимо отбросить его и вызов authorization для нового объекта авторизации.

    Объявление

    Objective C

    - (void)authorizationViewCreatedAuthorization:(SFAuthorizationView *)view

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

    Objective C

    @import SecurityInterface;

    Доступность

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

  • authorizationViewDidAuthorize: authorizationViewDidAuthorize:

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

    Объявление

    Objective C

    - (void)authorizationViewDidAuthorize:(SFAuthorizationView *)view

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

    Objective C

    @import SecurityInterface;

    Доступность

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

  • authorizationViewDidDeauthorize: authorizationViewDidDeauthorize:

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

    Объявление

    Objective C

    - (void)authorizationViewDidDeauthorize:(SFAuthorizationView *)view

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

    Objective C

    @import SecurityInterface;

    Доступность

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

  • authorizationViewDidHide: authorizationViewDidHide:

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

    Объявление

    Objective C

    - (void)authorizationViewDidHide:(SFAuthorizationView *)view

    Обсуждение

    Этот метод делегата, если есть вызывается каждый раз, когда setHidden: метод вызывают, чтобы показать или скрыть представление.

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

    Objective C

    @import SecurityInterface;

    Доступность

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

  • authorizationViewReleasedAuthorization: authorizationViewReleasedAuthorization:

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

    Объявление

    Objective C

    - (void)authorizationViewReleasedAuthorization:(SFAuthorizationView *)view

    Обсуждение

    Этот метод вызывают после того, как deauthorization был утвержден (любой, которого Вы вызвали deauthorize: метод или пользователь щелкнул по открытому значку блокировки и authorizationViewShouldDeauthorize: метод делегата не отменял работу), и прежде чем пользователь будет deauthorized (т.е. перед authorizationViewDidDeauthorize: метод делегата вызывают).

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

    Objective C

    @import SecurityInterface;

    Доступность

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

    См. также

    – deauthorize:
    – authorizationViewShouldDeauthorize:
    – authorizationViewDidDeauthorize: