Share via


IOleControlSite::TranslateAccelerator (Windows CE 5.0)

Send Feedback

Instructs the control site to process the keystroke described in pMsg and modified by the flags in grfModifiers.

HRESULT TranslateAccelerator(   LPMSG pMsg ,  DWORD grfModifiers);

Parameters

  • pMsg
    [in] Pointer to the MSG structure describing the keystroke to be processed.
  • grfModifiers
    [in] Flags describing the state of the Control, Alt, and Shift keys. The value of the flag can be any valid KEYMODIFIERS enumeration values.

Return Values

This method supports the following return values:

Value Description
S_OK The container processed the message.
E_NOTIMPL The container does not implement accelerator support.
S_FALSE The container did not process the message. This value must also be returned in all other error cases besides E_NOTIMPL.

Remarks

This method is called by a control that can be UI-active. In such cases, a control can process all keystrokes first through IOleInPlaceActiveObject::TranslateAccelerator, according to normal OLE Compound Document rules. Inside that method, the control can give the container certain messages to process first by calling IOleControlSite::TranslateAccelerator and using the return value to determine if any processing took place. Otherwise, the control always processes the message first. If the control does not use the keystroke as an accelerator, it passes the keystroke to the container through this method.

Requirements

OS Versions: Windows CE 4.0 and later.
Header: ocidl.h.

See Also

COM Interfaces

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.