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

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

Разработчик

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

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

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

SFChooseIdentityPanel

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

Идентификационные данные являются цифровым сертификатом вместе с его связанным закрытым ключом. Этот класс также позволяет пользователю отображать содержание любого сертификата в списке.

Следующие данные показывают пример выбрать панели идентификационных данных.

Панель идентификационных данных рисунка 1Choose image: ../Art/choose_ident_panel.eps

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

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

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

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

Objective C

@import SecurityInterface;

Доступность

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

Возврат совместно используемого объекта панели сертификата
  • sharedChooseIdentityPanel + sharedChooseIdentityPanel

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

    Объявление

    Objective C

    + (SFChooseIdentityPanel *)sharedChooseIdentityPanel

    Обсуждение

    Используйте этот метод, если Ваши отображения приложения сингл выбирают панель идентификационных данных или лист за один раз. Если Ваше приложение может вывести на экран многократный, выбирают панели идентификационных данных или листы сразу, необходимо выделить экземпляры отдельного объекта (использующий alloc метод класса наследовался от NSObject) и инициализируйте их (использование init метод экземпляра, также наследованный от NSObject) вместо того, чтобы использовать этот метод класса.

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

    Objective C

    @import SecurityInterface;

    Доступность

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

    См. также

    +alloc(NSObject)
    -init(NSObject)

Обеспечение справки
  • setHelpAnchor: - setHelpAnchor:

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

    Объявление

    Objective C

    - (void)setHelpAnchor:(NSString *)anchor

    Параметры

    anchor

    Новая строка привязки к справке.

    Обсуждение

    Если Вы выводите на экран кнопку справки в листе или модальной панели и не реализуете метод делегата, можно вызвать эту функцию для установки строки привязки к справке certificatePanelShowHelp:, или если возвращается метод делегата NOfalse. При отображении кнопки справки не устанавливайте строку привязки к справке и не реализуйте делегата, панель сертификата выводит на экран страницу справки по умолчанию (“Что такое цифровые идентификационные данные?”).

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

    Objective C

    @import SecurityInterface;

    Доступность

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

    См. также

    – setShowsHelp:
    – chooseIdentityPanelShowHelp:
    – helpAnchor

  • setShowsHelp: - setShowsHelp:

    Выводит на экран кнопку Help в листе или панели.

    Объявление

    Objective C

    - (void)setShowsHelp:(BOOL)showsHelp

    Параметры

    showsHelp

    Набор к YEStrue вывести на экран кнопку справки. Кнопка справки скрыта по умолчанию.

    Обсуждение

    Когда пользователь нажимает кнопку справки, выбрать панель идентификационных данных сначала проверяет делегата к a certificatePanelShowHelp: метод. Если делегат не реализует такой метод или возвраты метода делегата NOfalse, тогда NSHelpManager метод openHelpAnchor:inBook: вызывается с a nil книга и привязка, указанная setHelpAnchor: метод. Если делегат возвращается, исключение повышено NOfalse и нет никакого набора привязки к справке.

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

    Objective C

    @import SecurityInterface;

    Доступность

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

    См. также

    – chooseIdentityPanelShowHelp:
    – setHelpAnchor:
    -openHelpAnchor:inBook: (NSHelpManager)
    – showsHelp

  • helpAnchor - helpAnchor

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

    Объявление

    Objective C

    - (NSString *)helpAnchor

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

    Objective C

    @import SecurityInterface;

    Доступность

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

    См. также

    – setHelpAnchor:

  • showsHelp - showsHelp

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

    Объявление

    Objective C

    - (BOOL)showsHelp

    Обсуждение

    Этот метод возвраты YEStrue если кнопка справки в настоящее время устанавливается быть выведенной на экран.

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

    Objective C

    @import SecurityInterface;

    Доступность

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

    См. также

    – setShowsHelp:

Настройка появления листа или панели
  • setAlternateButtonTitle: - setAlternateButtonTitle:

    Настраивает заголовок альтернативной кнопки.

    Объявление

    Objective C

    - (void)setAlternateButtonTitle:(NSString *)title

    Параметры

    title

    Новый заголовок для альтернативной кнопки. Если этот метод не вызывают, или если title установлен в nil, кнопка не показана.

    Обсуждение

    Альтернативная кнопка обычно маркируется «Отмена». Альтернативная кнопка отклоняет лист или панель и возвращает значение NSCancelButton.

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

    Objective C

    @import SecurityInterface;

    Доступность

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

    См. также

    – setDefaultButtonTitle:

  • setDefaultButtonTitle: - setDefaultButtonTitle:

    Настраивает заголовок кнопки по умолчанию.

    Объявление

    Objective C

    - (void)setDefaultButtonTitle:(NSString *)title

    Параметры

    title

    Новый заголовок для кнопки по умолчанию. Заголовком по умолчанию для этой кнопки является «OK».

    Обсуждение

    Кнопка по умолчанию отклоняет лист или панель и возвращает значение NSOKButton.

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

    Objective C

    @import SecurityInterface;

    Доступность

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

    См. также

    – setAlternateButtonTitle:

  • setPolicies: - setPolicies:

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

    Объявление

    Objective C

    - (void)setPolicies:(id)policies

    Параметры

    policies

    Политики использовать при оценке состояния сертификатов. Можно передать любого a SecPolicyRef возразите или NSArray (содержащий один или больше SecPolicyRef экземпляры) в этом параметре. Если policies установлен в nil, Apple X.509 Базовая Политика используется.

    Обсуждение

    SFChooseIdentityPanel класс оценивает доверие для сертификатов, которые это выводит на экран. Приложения обычно выводят на экран сертификаты в контексте определенного использования, такие как SSL или S/MIME. Необходимо установить только ссылки политики, применяющиеся к надлежащему использованию. См. Политики Доверия AppleX509TP для списка политик и идентификаторов объектов, предоставленных модулем AppleX509TP.

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

    Objective C

    @import SecurityInterface;

    Доступность

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

    См. также

    – политики

  • политики - политики

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

    Объявление

    Objective C

    - (NSArray *)policies

    Обсуждение

    Этот метод возвращает автовыпущенный NSArray, содержащий один или несколько объектов типа SecPolicyRef , как установлено предыдущим setPolicies: вызовите, или Apple X.509 Базовая Политика если setPolicies: не был вызван. См. Политики Доверия AppleX509TP в Сертификате, Ключе и Ссылке Trust Services для списка политик и идентификаторов объектов, предоставленных модулем AppleX509TP.

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

    Objective C

    @import SecurityInterface;

    Доступность

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

    См. также

    – setPolicies:

  • informativeText - informativeText

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

    Объявление

    Objective C

    - (NSString *)informativeText

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

    Objective C

    @import SecurityInterface;

    Доступность

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

  • setInformativeText: - setInformativeText:

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

    Объявление

    Objective C

    - (void)setInformativeText:(NSString *)informativeText

    Параметры

    informativeText

    Строка, содержащая имя хоста, имя RFC 822 (адрес электронной почты), URL или подобный идентификатор.

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

    Objective C

    @import SecurityInterface;

    Доступность

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

Отображение листа или панели
  • beginSheetForWindow:modalDelegate:didEndSelector:contextInfo:identities:message: - beginSheetForWindow:modalDelegate:didEndSelector:contextInfo:identities:message:

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

    Объявление

    Objective C

    - (void)beginSheetForWindow:(NSWindow *)docWindow modalDelegate:(id)delegate didEndSelector:(SEL)didEndSelector contextInfo:(void *)contextInfo identities:(NSArray *)identities message:(NSString *)message

    Параметры

    docWindow

    Родительское окно, к которому присоединяется лист.

    delegate

    Объект делегата, в котором метод указал в didEndSelector параметр реализован.

    didEndSelector

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

    contextInfo

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

    identities

    Массив объектов идентификационных данных (объекты типа SecIdentityRef). Используйте SecIdentitySearchCopyNext функция (в Security/SecIdentitySearch.h) для нахождения объектов идентификационных данных.

    message

    Строка сообщения для отображения в листе.

    Обсуждение

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

    Метод делегата имеет следующую подпись:

    • -(void)createPanelDidEnd:(NSWindow *)sheet
    • returnCode:(int)returnCode
    • contextInfo:(void *)contextInfo

    Параметры для метода делегата:

    sheet

    Окно, к которому был присоединен лист.

    returnCode

    Код результата, указывающий, которые снабжают кнопками пользователя, щелкнул: также NSFileHandlingPanelOKButton или NSFileHandlingPanelCancelButton.

    contextInfo

    Определенные клиентами контекстные данные, передающиеся в contextInfo параметр beginSheetForWindow:... метод.

    Лист отклонен по возврату из beginSheetForWindow:... метод.

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

    Objective C

    @import SecurityInterface;

    Доступность

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

    См. также

    SecIdentitySearchCopyNext (Security/SecIdentitySearch.h)
    – идентификационные данные
    – runModalForIdentities:message:

  • runModalForIdentities:message: - runModalForIdentities:message:

    Выводит на экран список идентификационных данных в модальной панели.

    Объявление

    Objective C

    - (NSInteger)runModalForIdentities:(NSArray *)identities message:(NSString *)message

    Параметры

    identities

    Массив объектов идентификационных данных (объекты типа SecIdentityRef. Используйте SecIdentitySearchCopyNext функция (в Security/SecIdentitySearch.h) для нахождения объектов идентификационных данных.

    message

    Строка сообщения для отображения в панели.

    Обсуждение

    Этот метод возвраты NSOKButton если кнопка по умолчанию нажата, или NSCancelButton если нажата альтернативная кнопка.

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

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

    Objective C

    @import SecurityInterface;

    Доступность

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

    См. также

    SecIdentitySearchCopyNext (Security/SecIdentitySearch.h)
    – идентификационные данные
    – beginSheetForWindow:modalDelegate:didEndSelector:contextInfo:identities:message:

Получение информации идентификационных данных от листа или панели

Работа с доменами
  • домен - домен

    Возвращает домен, который будет связан с выбранными идентификационными данными.

    Объявление

    Objective C

    - (NSString *)domain

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

    Objective C

    @import SecurityInterface;

    Доступность

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

  • setDomain: - setDomain:

    Устанавливает дополнительный домен, в котором должны использоваться идентификационные данные.

    Объявление

    Objective C

    - (void)setDomain:(NSString *)domainString

    Параметры

    domainString

    Строка, содержащая имя хоста, имя RFC 822 (адрес электронной почты), URL или подобный идентификатор.

    Обсуждение

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

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

    Objective C

    @import SecurityInterface;

    Доступность

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

Методы делегата для обеспечения справки
  • chooseIdentityPanelShowHelp: chooseIdentityPanelShowHelp:

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

    Объявление

    Objective C

    - (BOOL)chooseIdentityPanelShowHelp:(SFChooseIdentityPanel *)sender

    Обсуждение

    Если Вы вызываете, можно использовать этот метод делегата реализовать пользовательскую справку setShowsHelp: метод для отображения кнопки справки в листе или панели. Если Вы не реализуете пользовательскую справку, не реализуйте этот метод.

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

    Objective C

    @import SecurityInterface;

    Доступность

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

    См. также

    – setShowsHelp:
    -setDelegate: (NSWindow)