Class

SFAuthorizationPluginView

The SFAuthorizationPluginView class allows authorization plug-in developers to create a custom view their plug-in can display.

Overview

If you’re developing an authorization plug-in, you can subclass the SFAuthorizationPluginView class to create views that provide a custom user interface for your plug-in. By subclassing the SFAuthorizationPluginView class, you avoid changing or duplicating the Apple-provided authentication or login window dialogs to display your custom view.

To instantiate your SFAuthorizationPluginView subclass, you need the callbacks structure containing entry points to the Security Server that you receive in your plug-in’s AuthorizationPluginCreate function and the authorization engine handle you receive in your plug-in’s MechanismCreate function.

Your custom subclass of SFAuthorizationPluginView must override the following methods:

Symbols

Initializing an SFAuthorizationPluginView Object

- initWithCallbacks:andEngineRef:

Returns an SFAuthorizationPluginView object with the specified callbacks and authorization engine handle.

Getting Instance Information

- callbacks

Returns the AuthorizationCallbacks structure with which this instance was initialized.

- engineRef

Returns the authorization engine handle with which this instance was initialized.

- lastError

Returns the last error that occurred during evaluation.

Responding to User Actions

- buttonPressed:

Informs the SFAuthorizationPluginView instance when a user presses a button in the custom view.

- viewForType:

Returns the appropriate NSView object for the specified SFViewType.

Configuring the User Interface

- didActivate

Informs the SFAuthorizationPluginView instance when the authorization plug-in makes the instance’s user interface active.

- didDeactivate

Informs the SFAuthorizationPluginView instance when the authorization plug-in deactivates its user interface.

- willActivateWithUser:

Informs the SFAuthorizationPluginView instance when its user interface is about to be made active by the Apple-provided Security Agent.

Setting Up the Keyboard Loop

- firstKeyView

Returns the first view in the keyboard loop of the view.

- firstResponder

Returns the view that should get focus for keyboard events.

- lastKeyView

Returns the last view in the keyboard loop of the view.

Enabling and Disabling Controls

- setEnabled:

Enables or disables the controls in the SFAuthorizationPluginView instance’s view.

Communicating with the Authorization Plug-in

- displayView

Displays the user interface provided by the SFAuthorizationPluginView subclass.

- setButton:enabled:

Enables or disables a button in the SFAuthorizationPluginView instance’s user interface.

- updateView

Tells the authorization plug-in to get and display the appropriate view in the SFAuthorizationPluginView instance’s user interface.

Constants

SFButtonType

These constants define the button types used by authorization plug-ins.

SFViewType

These constants define the view type requested by the authorization plug-in.

Exceptions

Exceptions thrown by the SFAuthorizationPluginView class

Relationships

Inherits From