IOleInPlaceFrame::EnableModeless method

Enables or disables a frame's modeless dialog boxes.

Syntax

HRESULT EnableModeless(
  [in] BOOL fEnable
);

Parameters

fEnable [in]

Specifies whether the modeless dialog box windows are to be enabled (TRUE) or disabled (FALSE).

Return value

This method returns S_OK if the dialog box was either enabled or disabled successfully, depending on the value for fEnable.

Security Considerations

Notes to Callers

The active in-place object calls EnableModeless to enable or disable modeless dialog boxes that the container might be displaying. To display a modal dialog box, the object first calls EnableModeless, specifying FALSE to disable the container's modeless dialog box windows. After completion, the object calls EnableModeless, specifying TRUE to reenable them.

Notes to Implementers

You should track the value of EnableModeless and check it before displaying a dialog box.

Requirements

See also

IOleInPlaceFrame

IOleInPlaceActiveObject::EnableModeless