MM Developer's Guide
MM Interfaces | MM Methods | MM Types and Misc API
Interface ID: IID_IMoaMmWndWin
Pointer type: PIMoaMmWndWin
Inheritance: IMoaUnknown
Header file: mmiwndw.h
Description
- This interface supports Windows-specific user interface display.
- As an alternative to this platform-specific API, consider using
the MUI XDK instead. It
provides platform-independent interfaces that support dialogs
containing a variety of widget types, including dynamic layout
capabilities and a standard event-handling mechanism. The MUI
API also lets you easily display system alerts, file dialogs,
and URL dialogs. See the MUI Developer's
Guide for information on which applications support the MUI API and
MUI Xtra.
- With IMoaMmUtils2, IMoaMmValue,
and IMoaMmWndMac, this interface supercedes IMoaMmUtils, which has been made redundant.
Methods
- WinDialogBox()
WinGetParent()
WinDialogBoxParam()
WinPrepareDialogBox()
WinUnprepareDialogBox()
Syntax
- WinDialogBox(XtraResourceCookie resCookie, ConstPMoaChar lpszTemplate, PMoaVoid dlgprc)
Parameters
- resCookie
- XtraResourceCookie
- lpszTemplate
- ConstPMoaChar
- dlgprc
- PMoaVoid
Returns
- MoaLong
Description
- Use this on Windows instead of calling the Windows API DialogBox() function.
This allows the host application to perform any special handling
it may require when a modal dialog is displayed. This also sets
the parent window correctly so there is no need to pass the window
in as an argument. Be sure to bracket your call to WinDialogBox() with calls to MoaBeginUsingResources(), MoaEndUsingResources().
Pass in the cookie you get as a return value from MoaBeginUsingResources() as the first argument to WinDialogBox() (the HINST).
Syntax
- WinDialogBoxParam(
XtraResourceCookie resCookie, ConstPMoaChar lpszTemplate, PMoaVoid dlgprc, MoaLong lparamInit)
Parameters
- resCookie
- XtraResourceCookie
- lpszTemplate
- ConstPMoaChar
- dlgprc
- PMoaVoid
- lparamInit
- MoaLong
Returns
- MoaLong
Description
- Same as WinDialogBox(),
except takes the lparamInit argument to pass as an initial value to the event processor function.
Use this on Windows instead of calling the Windows API DialogBoxParam() function.
Syntax
- WinGetParent(MoaMmHInst * phInst, MoaMmHWnd * phWnd)
Parameters
- phInst
- Handle to the host application's HINSTANCE
- phWnd
- Handle to the host application's parent window
Returns
- MoaError
Description
- Returns the HINSTANCE handle of the host application and the HWND handle to the parent window.
Syntax
- WinPrepareDialogBox(PMoaMmDialogCookie pDialogCookie)
Parameters
- pDialogCookie
- PMoaMmDialogCookie
Returns
- MoaError
Description
- Call this method before showing a system or other type of
dialog box on Windows. If you're using WinDialogBox() or
WindDialogBoxParam(),
you do not need to call this method.
Syntax
- WinUnprepareDialogBox(MoaMmDialogCookie dialogCookie)
Parameters
- dialogCookie
- MoaMmDialogCookie
Returns
- MoaError
Description
- Call this method after showing a system or other type of dialog
box on Windows. If you're using WinDialogBox() or WindDialogBoxParam(),
you do not need to call this method.
Copyright © 1995-2008 Adobe Macromedia Software LLC, Inc.