IBuilderWizardManager.EnableModeless(Int32) Method

Reference

Definition

Namespace:: Microsoft.VisualStudio.Shell.Interop

Assembly:: Microsoft.VisualStudio.Shell.Interop.8.0.dll

Assembly:: Microsoft.VisualStudio.Interop.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Sets builder dialogs to modeless or modal.

public:
 int EnableModeless(int fEnable);

public:
 int EnableModeless(int fEnable);

int EnableModeless(int fEnable);

public int EnableModeless (int fEnable);

abstract member EnableModeless : int -> int

Public Function EnableModeless (fEnable As Integer) As Integer

Parameters

fEnable: Int32

[in] true to enable modeless dialogs; false otherwise.

Returns

Int32

Returns S_OK. This method does not fail.

Remarks

Builders returned by GetBuilder run as modal builders. The IBuilderWizardManager client is responsible for disabling the application prior to invoking the builder, and then re-enabling the application after the method returns. You can do this several ways:

If the client is internal to the application implementing IBuilderWizardManager, the client can use the private mechanisms of the application.
If the client is a standard in-place OLE object, then it can call the EnableModeless method of the IOleInPlaceFrame interface.
If the client is registered with IOleComponentManager it can use the OnComponentEnterState and FOnComponentExitState methods of the IOleComponentManager interface to manage mode.
If the client is not an in-place object and has no other way to disable the application, it can use the EnableModeless method.

Applies to