SFCertificatePanel

SFCertificatePanel класс выводит на экран один или несколько сертификатов в панели или листе. Это может дополнительно вывести на экран все сертификаты в цепочке сертификата.

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

Этот класс выводит на экран подробные данные сертификата, но не доверительные настройки. Для отображения сертификата с доступными для редактирования доверительными настройками в панели или листе используйте SFCertificateTrustPanel класс (SFCertificateTrustPanel). Для отображения сертификатов в пользовательском представлении используйте SFCertificateView класс (SFCertificateView).

Обратите внимание на то, что для OS X v10.4 и позже, этот класс выводит на экран состояние оценки для каждого сертификата. Можно изменить, как сертификаты оценены путем вызова setPolicies: метод.

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

NSObject
NSResponder
NSWindow
NSPanel
SFCertificatePanel
SFCertificateTrustPanel

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

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

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

Objective C

@import SecurityInterface;

Доступность

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

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

sharedCertificatePanel + sharedCertificatePanel

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

Объявление

Objective C

+ (SFCertificatePanel *)sharedCertificatePanel

Обсуждение

Используйте этот метод если Ваши отображения приложения единственная панель сертификата или лист за один раз. Если Ваше приложение может вывести на экран многократные панели сертификата или листы сразу, необходимо выделить экземпляры отдельного объекта (использующий 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:
– certificatePanelShowHelp:
– 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

См. также

– certificatePanelShowHelp:
– 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:
runModalForTrust:message:


    
    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 Базовая Политика используется.

Обсуждение

Приложения обычно выводят на экран панель сертификата в контексте определенного использования, такого как 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:

Отображение листа или панели


    
    beginSheetForWindow:modalDelegate:didEndSelector:contextInfo:certificates:showGroup:
    - beginSheetForWindow:modalDelegate:didEndSelector:contextInfo:certificates:showGroup:

Дисплеи один или несколько сертификатов в модальном листе.

Объявление

Objective C

- (void)beginSheetForWindow:(NSWindow *)docWindow modalDelegate:(id)delegate didEndSelector:(SEL)didEndSelector contextInfo:(void *)contextInfo certificates:(NSArray *)certificates showGroup:(BOOL)showGroup

Параметры

`docWindow`	Родительское окно, к которому присоединяется лист.
`delegate`	Объект делегата, в котором метод указал в `didEndSelector` параметр реализован.
`didEndSelector`	Когда лист был отклонен, селектор для метода делегата вызвал. Реализация этого метода делегата является дополнительной.
`contextInfo`	Указатель на данные, передающиеся методу делегата. Можно использовать этот указатель данных в любой цели, которой Вы желаете.
`certificates`	Сертификаты дисплею. Передайте NSArray, содержащий один или несколько объектов типа `SecCertificateRef` в этом параметре. Первый сертификат в массиве должен быть листовым сертификатом. Другие сертификаты (если таковые имеются) могут быть включены в любой порядок.
`showGroup`	Указывает, выведены ли дополнительные сертификаты (кроме листового сертификата) на экран.

Обсуждение

Поведение этого метода несколько отличается в OS X v10.4 и позже по сравнению с OS X v10.3. В OS X v10.3, лист выводит на экран любые сертификаты, которые Вы передаете в certificates параметр (обеспечил showGroup параметр устанавливается на YEStrue). Начиная с OS X v10.4, лист выводит на экран листовой сертификат (т.е. первый сертификат в массиве, который Вы передаете) плюс любые другие сертификаты в цепочке сертификата, которую может найти Сервер безопасности. Если Вы включаете все сертификаты в цепочке в certificates параметр, можно гарантировать, что те же сертификаты выведены на экран, что версию операционной системы, и может уменьшить время, требуемое найти и вывести на экран сертификаты в OS X v10.4 и позже.

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

      -(void)certificateSheetDidEnd:(NSWindow *)sheet
       returnCode:(NSInteger)returnCode
       contextInfo:(void *)contextInfo

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

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

Метод делегата может отклонить сам лист настроек цепочки для ключей; если это не делает, лист отклонен по возврату из beginSheetForDirectory:... метод.

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

Objective C

@import SecurityInterface;

Доступность

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

См. также

– runModalForCertificates:showGroup:


    
    beginSheetForWindow:modalDelegate:didEndSelector:contextInfo:trust:showGroup:
    - beginSheetForWindow:modalDelegate:didEndSelector:contextInfo:trust:showGroup:

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

Объявление

Objective C

- (void)beginSheetForWindow:(NSWindow *)docWindow modalDelegate:(id)delegate didEndSelector:(SEL)didEndSelector contextInfo:(void *)contextInfo trust:(SecTrustRef)trust showGroup:(BOOL)showGroup

Параметры

`docWindow`	Родительское окно, к которому присоединяется лист.
`delegate`	Объект делегата, в котором метод указал в `didEndSelector` параметр реализован.
`didEndSelector`	Когда лист был отклонен, селектор для метода делегата вызвал. Реализация этого метода делегата является дополнительной.
`contextInfo`	Указатель на данные, передающиеся методу делегата. Можно использовать этот указатель данных в любой цели, которой Вы желаете.
`trust`	A `SecTrustRef` объект для сертификатов, которые будут выведены на экран.
`showGroup`	Указывает, выведены ли дополнительные сертификаты (кроме листового сертификата) на экран.

Обсуждение

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

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

      -(void)certificateSheetDidEnd:(NSWindow *)sheet
       returnCode:(NSInteger)returnCode
       contextInfo:(void *)contextInfo

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

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

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

Objective C

@import SecurityInterface;

Доступность

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

certificateView - certificateView

Возвраты SFCertificateView экземпляр для модальной панели.

Объявление

Objective C

- (SFCertificateView *)certificateView

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

Objective C

@import SecurityInterface;

Доступность

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


    
    runModalForCertificates:showGroup:
    - runModalForCertificates:showGroup:

Дисплеи один или несколько указанные сертификаты в модальной панели.

Объявление

Objective C

- (NSInteger)runModalForCertificates:(NSArray *)certificates showGroup:(BOOL)showGroup

Параметры


      certificates

Сертификаты дисплею. Передайте NSArray, содержащий один или несколько объектов типа SecCertificateRef в этом параметре. Первый сертификат в массиве должен быть листовым сертификатом. Другие сертификаты (если таковые имеются) могут быть включены в любой порядок.


      showGroup

Указывает, выведены ли дополнительные сертификаты (кроме листового сертификата) на экран. Для показа только единственного сертификата укажите только один SecCertificateRef в массиве и наборе showGroup к NOfalse.

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

Этот метод возвращает целочисленную константу NSOKButton когда отклонено.

Обсуждение

Поведение этого метода несколько отличается в OS X v10.4 и позже по сравнению с OS X v10.3. В OS X v10.3, панель выводит на экран любые сертификаты, которые Вы передаете в certificates параметр (обеспечил showGroup параметр устанавливается на YEStrue). Начиная с OS X v10.4, панель выводит на экран листовой сертификат (т.е. первый сертификат в массиве, который Вы передаете) плюс любые другие сертификаты в цепочке сертификата, которую может найти Сервер безопасности. Если Вы включаете все сертификаты в цепочке в certificates параметр, можно гарантировать, что те же сертификаты выведены на экран, что версию операционной системы, и может уменьшить время, требуемое найти и вывести на экран сертификаты в OS X v10.4 и позже.

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

Objective C

@import SecurityInterface;

Доступность

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

См. также

– beginSheetForWindow:modalDelegate:didEndSelector:contextInfo:certificates:showGroup:


    
    runModalForTrust:showGroup:
    - runModalForTrust:showGroup:

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

Объявление

Objective C

- (NSInteger)runModalForTrust:(SecTrustRef)trust showGroup:(BOOL)showGroup

Параметры

`trust`	A `SecTrustRef` объект связался с цепочкой сертификата для отображения.
`showGroup`	Указывает, выведены ли дополнительные сертификаты (кроме листового сертификата) на экран. Для показа только единственного сертификата укажите только один `SecCertificateRef` в массиве и наборе `showGroup` к `NOfalse`.

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

Этот метод возвращает целочисленную константу NSOKButton когда отклонено.

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

Objective C

@import SecurityInterface;

Доступность

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

См. также

– beginSheetForWindow:modalDelegate:didEndSelector:contextInfo:trust:showGroup:

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

certificatePanelShowHelp: certificatePanelShowHelp:

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

Объявление

Objective C

- (BOOL)certificatePanelShowHelp:(SFCertificatePanel *)sender

Обсуждение

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

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

Objective C

@import SecurityInterface;

Доступность

OS X v10.4

См. также

– setShowsHelp:
setDelegate: (NSWindow)