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

Overview

Manages a panel that allows users to specify the parameters of an burn.

Discussion

This class supports choosing the the device to use, whether or not to verify the burned data and how to handle the burned disc when it completes.

Methods

-appendable:

Invoked when the user clicks the panel's appendable checkbox.

-burnObject

Creates and returns a new DRBurn object that's configured to write data to the currently selected device.

-burnSpeed:

Invoked when the user clicks the panel's burn speed popup button.

-completionAction:

Invoked when the user clicks one of the panel's completion action radio buttons.

-expand:

Invoked when the user clicks the panel's expand button.

-setCanSelectAppendableMedia:

Specifies whether the user can choose to leave the disc appendable.

-setCanSelectTestBurn:

Specifies whether the user can choose to make a test burn.

-setDefaultButtonTitle:

Sets the title for the receiver's default button to title.

+setupPanel

Creates and return an instance of a burn setup panel.

-testBurn:

Invoked when the user clicks the panel's test burn checkbox.

-verifyBurn:

Invoked when the user clicks the panel's verify burn checkbox.

Invoked when the user clicks the panel's appendable checkbox.

- (IBAction) appendable:(id) sender; 

Creates and returns a new DRBurn object that's configured to write data to the currently selected device.

- (DRBurn*) burnObject; 

Return Value

A new DRBurn object.

Discussion

The new DRBurn object is configured based on the settings in the setup panel when the user clicks the OK button.

Do not invoke this method within a modal session ( runSetupPanel or beginSetupSheetForWindow:modalDelegate:didEndSelector:contextInfo: ) because the burn object information is only updated just before the modal session ends.

Invoked when the user clicks the panel's burn speed popup button.

- (IBAction) burnSpeed:(id) sender; 

Invoked when the user clicks one of the panel's completion action radio buttons.

- (IBAction) completionAction:(id) sender; 

Invoked when the user clicks the panel's expand button.

- (IBAction) expand:(id) sender; 

Specifies whether the user can choose to leave the disc appendable.

- (void) setCanSelectAppendableMedia:(BOOL)flag; 

Parameters

Discussion

This method controls whether the appendable checkbox is enabled.

If the data being writen to disc does not lend itself to having more data appended on to it, you can disable the ability of the user to leave the disc open.

This method must be called before the panel is displayed.

Specifies whether the user can choose to make a test burn.

- (void) setCanSelectTestBurn:(BOOL)flag; 

Parameters

Discussion

This method controls whether a checkbox should be added to the receiver that allows the user to set the burn to be a test burn. By default, the test burn button is not displayed.

This method must be called before the panel is displayed.

Sets the title for the receiver's default button to title.

- (void) setDefaultButtonTitle:(NSString*)title; 

Discussion

Normally, the default button is “Burn”.

Creates and return an instance of a burn setup panel.

+ (DRBurnSetupPanel*) setupPanel; 

Return Value

A pointer to the newly created DRBurnSetupPanel.

Invoked when the user clicks the panel's test burn checkbox.

- (IBAction) testBurn:(id) sender; 

Invoked when the user clicks the panel's verify burn checkbox.

- (IBAction) verifyBurn:(id) sender;