Microsoft DirectX 9.0 SDK Update (October 2004)

Device.SetDialogBoxesEnabled Method

Language:

Note: This documentation is preliminary and is subject to change.

Enables the use of Microsoft® Windows® Graphics Device Interface (GDI) dialog boxes in full-screen applications.

Definition

Visual Basic .NET Public Sub SetDialogBoxesEnabled( _
    ByVal value As Boolean _
)
C# public void SetDialogBoxesEnabled(
    bool value
);
Managed C++ public: void SetDialogBoxesEnabled(
    bool value
);
JScript .NET public function SetDialogBoxesEnabled(
    value : boolean
);

Parameters

value System.Boolean. Set to true to enable Microsoft® Windows® Graphics Device Interface (GDI) dialog boxes. Set to false to disable Microsoft® Windows® Graphics Device Interface (GDI) dialog boxes.

Remarks

The Microsoft® Windows® Graphics Device Interface (GDI) dialog boxes must be created as child elements to the device window. They should also be created within the same thread that created the device, because this enables the parent window to manage redrawing of the child window.

This method has no effect on applications in windowed mode, but its setting takes effect if the application resets the device into full-screen mode. If SetDialogBoxesEnabled succeeds in a windowed-mode application, any subsequent reset to full-screen mode is checked against the restrictions cited above. Also, because SetDialogBoxesEnabled causes all back buffers on the swap chain to be discarded, an application is expected to refresh its content for all back buffers after the call.

Exceptions

InvalidCallException: The method call is invalid. For example, a method's parameter might contain an invalid value.

This method also might fail if the all of the following are conditions are present.


© 2004 Microsoft Corporation. All rights reserved. Terms of use.

Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center