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

IMoaMmWndWin

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()

WinDialogBox()

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).

WinDialogBoxParam()

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.

WinGetParent()

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.

WinPrepareDialogBox()

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.

WinUnprepareDialogBox()

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.