IBuilderWizardManager.EnableModeless(Int32) Method
Definition
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 -> intPublic Function EnableModeless (fEnable As Integer) As IntegerParameters
- fEnable
- Int32
[in] true to enable modeless dialogs; false otherwise.
Returns
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.