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(PIMoaMmWndWin This,
XtraResourceCookie resCookie,
ConstPMoaChar lpszTemplate,
PMoaVoid dlgprc)

Parameters

This
Pointer to the IMoaMmWndWin interface

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(PIMoaMmWndWin This,
XtraResourceCookie resCookie,
ConstPMoaChar lpszTemplate,
PMoaVoid dlgprc,
MoaLong lparamInit)

Parameters

This
Pointer to the IMoaMmWndWin interface

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(PIMoaMmWndWin This,
MoaMmHInst FAR * phInst,
MoaMmHWnd FAR * phWnd)

Parameters

This
Pointer to the IMoaMmWndWin interface

phInst
MoaMmHInst FAR *Handle to the host application's HINSTANCE

phWnd
MoaMmHWnd FAR *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(PIMoaMmWndWin This,
PMoaMmDialogCookie pDialogCookie)

Parameters

This
Pointer to the IMoaMmWndWin interface

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(PIMoaMmWndWin This,
MoaMmDialogCookie dialogCookie)

Parameters

This
Pointer to the IMoaMmWndWin interface

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-2007 Adobe Macromedia Software LLC, Inc.