Inside Macintosh: QuickTime Components /

Chapter 9 - Movie Data Exchange Components / Movie Data Exchange Components Reference

Configuring Movie Data Export Components /

MovieExportDoUserDialog

The MovieExportDoUserDialog function allows an application to request that your component display its user dialog box.

pascal ComponentResult MovieExportDoUserDialog 
                                    (ComponentInstance ci, 
                                     const FSSpec *theFile,
                                     Handle theData,
                                     Boolean *canceled);

ci

Identifies the application's connection to your movie data export component.

theFile

Contains a pointer to a valid file specification. If the export request pertains to a file, the application must specify the destination file with this parameter and set the parameter theData to nil. If the request is for a handle, this parameter is set to nil.

theData

Contains a handle to receive the converted data. If the export request pertains to a handle, the application must specify the destination handle with this parameter, and set the parameter theFile to nil. If the request is for a file, this parameter is set to nil.

canceled

Contains a pointer to a Boolean value. Your component should set this Boolean value to reflect whether the user cancels the dialog box. If the user cancels the dialog box, set the Boolean value to true. Otherwise, set it to false.

DESCRIPTION

Your movie data export component may support a user dialog box that allows the user to configure an export operation. For components that support such a dialog box, the MovieExportDoUserDialog function allows an application to tell you when to display the dialog box to the user.

If your component supports a user dialog box, be sure to set the hasMovieExportUserInterface flag in your component's componentFlags field.

RESULT CODE

badComponentSelector

0x80008002

Function not supported