MUI Developer's Guide
MUI Interfaces | MUI Methods | MUI Types and Misc API

IMuiFile

Interface ID: IID_IMuiFile
Pointer type: PIMuiFile
Inheritance: IMoaUnknown
Header file: mui.h

This interface displays the standard system file open and file save dialogs. It is available by calling IMoaCallback::CreateInstance() with the class identifier CLSID_CMuiFile and the interface identifier IID_IMuiFile.

See the MUI Developer's Guide for a list of the applications that currently support IMuiFile.

Use this interface in conjunction with the Moa File Support II API to open the file specified by the user.

Methods

SimpleFileOpen()
SimpleFileSave()

SimpleFileOpen()

Syntax

SimpleFileOpen(PIMoaPathName * ppMoaPath, ConstPMoaChar prompt)

Parameters

ppMoaPath
Pointer to an IMoaPathName to return the user's selection
prompt
Character string for the user prompt

Returns

MoaError

Description

Call this method to display a standard system file open dialog box from your Xtra. Pass a string for the user prompt to display in the dialog. Allocate and pass an instance of the IMoaPathName interface to specify the default file to save in the dialog; otherwise, an instance will be allocated for you and returned (caller owns). The instance returned contains the selection from the user.

Once the user has selected a file and dismissed the dialog, this method returns. Use standard system calls to open the file selected by the user.

SimpleFileSave()

Syntax

SimpleFileSave(PIMoaPathName * ppMoaPath, ConstPMoaChar prompt)

Parameters

ppMoaPath
Pointer to an IMoaPathName to return the user's selection
prompt
Character string for the user prompt

Returns

MoaError

Description

Call this method to display a standard system file save dialog box from your Xtra. Pass a string for the user prompt to display in the dialog. Allocate and pass an instance of the IMoaPathName interface to specify the default file to save in the dialog; otherwise, an instance will be allocated for you and returned (caller owns). The instance returned contains the selection from the user.

Once the user has selected a file and dismissed the dialog, this method returns. Use standard system calls to save to the file selected by the user.

Copyright © 1995-2008 Adobe Macromedia Software LLC, Inc.