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.

See Also

IOleWindow, IOleInPlaceUIWindow