Export (0) Print
Expand All

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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

OleIdl.h

IDL

OleIdl.Idl

IID

IID_IOleInPlaceFrame is defined as 00000116-0000-0000-C000-000000000046

See also

IOleInPlaceFrame
IOleInPlaceActiveObject::EnableModeless

 

 

Community Additions

ADD
Show:
© 2014 Microsoft