IOleInPlaceFrame::TranslateAccelerator method

Translates accelerator keystrokes intended for the container's frame while an object is active in place.

Syntax


HRESULT TranslateAccelerator(
  [in]  LPMSG lpmsg,
  [in]  WORD wID
);

Parameters

lpmsg [in]

A pointer to the MSG structure that contains the keystroke message.

wID [in]

The command identifier value corresponding to the keystroke in the container-provided accelerator table. Containers should use this value instead of translating again.

Return value

This method returns S_OK on success. Other possible return values include the following.

Return codeDescription
S_FALSE

The keystroke was not used.

E_INVALIDARG

The specified pointer is invalid.

E_UNEXPECTED

An unexpected error occurred.

 

Remarks

Notes to Callers

The IOleInPlaceFrame::TranslateAccelerator method is called indirectly by OleTranslateAccelerator when a keystroke accelerator intended for the container (frame) is received.

Notes to Implementers

The container application should perform its usual accelerator processing, or use wID directly, and then return, indicating whether the keystroke accelerator was processed. If the container is an MDI application and the TranslateAccelerator function fails, the container can call the TranslateMDISysAccel function, just as it does for its usual message processing.

In-place objects should be given first chance at translating accelerator messages. However, because objects implemented by DLL object applications do not have their own message pump, they receive their messages from the container's message queue. To ensure that the object has first chance at translating messages, a container should always call IOleInPlaceFrame::TranslateAccelerator before doing its own accelerator translation. Conversely, an executable object application should call OleTranslateAccelerator after calling TranslateAccelerator, calling TranslateMessage and DispatchMessage only if both translation functions fail.

You should define accelerator tables for containers so they will work properly with object applications that do their own accelerator keystroke translations. Tables should be defined as follows.

"char", wID, VIRTKEY, CONTROL

This is the most common way to describe keyboard accelerators. Failure to do so can result in keystrokes being lost or sent to the wrong object during an in-place session.

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
OleTranslateAccelerator
IOleInPlaceFrame::TranslateAccelerator
TranslateAccelerator
TranslateMDISysAccel

 

 

Community Additions

ADD
Show:
© 2014 Microsoft