Mac Dev Center Mac OS X Reference Library Drivers, Kernel, & Hardware: User-Space Device Access Disc Recording UI Framework Reference

Overview

This category defines a set of methods that delegates of the setup panels can implement to control the behavior of the panel.

Methods

-setupPanel:determineBestDeviceOfA:orB:

Allows the delegate to specify which device is its preferred.

-setupPanel:deviceContainsSuitableMedia:promptString:

This delegate method allows the delegate to determine if the media inserted in the device is suitable for whatever operation is to be performed.

-setupPanel:deviceCouldBeTarget:

Allows the delegate to determine if device can be used as a target.

-setupPanelDeviceSelectionChanged:

Sent by the default notification center when the device selection in the panel has changed.

-setupPanelShouldHandleMediaReservations:

This delegate method allows the delegate to control how media reservations are handled.

Allows the delegate to specify which device is its preferred.

- (DRDevice*) setupPanel:(DRSetupPanel*)aPanel 
        determineBestDeviceOfA:(DRDevice*)deviceA orB:(DRDevice*)device; 

Parameters

Return Value

One of the two device objects passed in.

Discussion

When the setup panel is first displayed and again, each time a new device appears, the setup panel will ask the delegate to compare two devices to determine which is most suitable for their content to burn.

This delegate method allows the delegate to determine if the media inserted in the device is suitable for whatever operation is to be performed.

- (BOOL) setupPanel:(DRSetupPanel*)aPanel 
        deviceContainsSuitableMedia:(DRDevice*)device promptString:(NSString**)prompt; 

Parameters

Return Value

Return NO to disable the default button.

Allows the delegate to determine if device can be used as a target.

- (BOOL) setupPanel:(DRSetupPanel*)aPanel 
        deviceCouldBeTarget:(DRDevice*)device; 

Parameters

Return Value

YES if the device is acceptable, NO if not.

Discussion

This method is used to limit the menu to only those devices that you want to appear. For example, a DVD burning application might use this to limit the menu to only devices that are capable of writing DVD-Rs.

Sent by the default notification center when the device selection in the panel has changed.

- (void) setupPanelDeviceSelectionChanged:(NSNotification*)aNotification; 

Parameters

This delegate method allows the delegate to control how media reservations are handled.

- (BOOL) setupPanelShouldHandleMediaReservations:(DRSetupPanel*)aPanel; 

Parameters

Return Value

Return NO to indicate the delegate will handle media reservations. Return YES to indicate the setupPanel should handle media reservations itself.