IBuilderWizardManager.EnableModeless Method
Sets builder dialogs to modeless or modal.
Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop.8.0 (in Microsoft.VisualStudio.Shell.Interop.8.0.dll)
Syntax
'Declaration
Function EnableModeless ( _
fEnable As Integer _
) As Integer
'Usage
Dim instance As IBuilderWizardManager
Dim fEnable As Integer
Dim returnValue As Integer
returnValue = instance.EnableModeless(fEnable)
int EnableModeless(
int fEnable
)
int EnableModeless(
[InAttribute] int fEnable
)
function EnableModeless(
fEnable : int
) : int
Parameters
fEnable
Type: System.Int32[in] true to enable modeless dialogs; false otherwise.
Return Value
Type: System.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.
.NET Framework Security
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.