IOleInPlaceFrame

The IOleInPlaceFrame interface controls the container's top-level frame window. This control involves allowing the container to insert its menu group into the composite menu, install the composite menu into the appropriate window frame, and remove the container's menu elements from the composite menu. It sets and displays status text relevant to the in-place object. It also enables or disables the frame's modeless dialog boxes, and translates accelerator keystrokes intended for the container's frame.

When to Implement

You will need to implement this interface if you are writing a container application that will be participating in in-place activation.

When to Use

This interface is used by object applications to control the display and placement of composite menus, keystroke accelerator translation, context-sensitive help mode, and modeless dialog boxes.

Methods in VTable Order

IUnknown Methods Description
QueryInterface Returns a pointer to a specified interface.
AddRef Increments the reference count.
Release Decrements the reference count.

IOleWindow Methods Description
GetWindow Gets a window handle.
ContextSensitiveHelp Controls enabling of context-sensitive help.

IOleInPlaceUIWindow Methods Description
GetBorder Translates messages.
RequestBorderSpace State of container's top-level frame.
SetBorderSpace State of container document window.
SetActiveObject Alert object of need to resize border space.

IOleInPlaceFrame Methods Description
InsertMenus Allows container to insert menus.
SetMenu Adds a composite menu to window frame.
RemoveMenus Removes a container's menu elements.
SetStatusText Sets and displays status text about.
EnableModeless Enables or disables modeless dialog boxes.
TranslateAccelerator Translates keystrokes.

QuickInfo

  Windows NT: Use version 3.1 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in oleidl.h.

See Also

IOleWindow, IOleInPlaceUIWindow