nf-oleidl-ioleinplaceactiveobject-translateaccelerator.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:oleidl.IOleInPlaceActiveObject.TranslateAccelerator	IOleInPlaceActiveObject::TranslateAccelerator (oleidl.h)	Processes menu accelerator-key messages from the container's message queue. This method should only be used for objects created by a DLL object application.	IOleInPlaceActiveObject interface [COM] TranslateAccelerator method IOleInPlaceActiveObject.TranslateAccelerator IOleInPlaceActiveObject::TranslateAccelerator TranslateAccelerator TranslateAccelerator method [COM] TranslateAccelerator method [COM] IOleInPlaceActiveObject interface _ole_ioleinplaceactiveobject_translateaccelerator com.ioleinplaceactiveobject_translateaccelerator oleidl/IOleInPlaceActiveObject::TranslateAccelerator	com\ioleinplaceactiveobject_translateaccelerator.htm	com	ce460c52-c7aa-4ee4-955e-76407af7cf1e	12/05/2018	IOleInPlaceActiveObject interface [COM],TranslateAccelerator method, IOleInPlaceActiveObject.TranslateAccelerator, IOleInPlaceActiveObject::TranslateAccelerator, TranslateAccelerator, TranslateAccelerator method [COM], TranslateAccelerator method [COM],IOleInPlaceActiveObject interface, _ole_ioleinplaceactiveobject_translateaccelerator, com.ioleinplaceactiveobject_translateaccelerator, oleidl/IOleInPlaceActiveObject::TranslateAccelerator	oleidl.h		Windows	Windows 2000 Professional [desktop apps only]	Windows 2000 Server [desktop apps only]					OleIdl.Idl								Windows			19H1	IOleInPlaceActiveObject::TranslateAccelerator oleidl/IOleInPlaceActiveObject::TranslateAccelerator	c++	APIRef kbSyntax	COM	OleIdl.h	IOleInPlaceActiveObject.TranslateAccelerator

IOleInPlaceActiveObject::TranslateAccelerator

-description

Processes menu accelerator-key messages from the container's message queue. This method should only be used for objects created by a DLL object application.

-parameters

-param lpmsg [in]

A pointer to an MSG structure for the message that might need to be translated.

-returns

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

Return code	Description
S_FALSE	The message was not translated.
E_INVALIDARG	The specified parameter values are not valid.
E_OUTOFMEMORY	IThere is insufficient memory available for the operation.
E_UNEXPECTED	An unexpected error has occurred.

-remarks

Notes to Callers

Active in-place objects must always be given the first chance at translating accelerator keystrokes. You can provide this opportunity by calling IOleInPlaceActiveObject::TranslateAccelerator from your container's message loop before doing any other translation. You should apply your own translation only when this method returns S_FALSE.

If you call IOleInPlaceActiveObject::TranslateAccelerator for an object that is not created by a DLL object application, the default object handler returns S_FALSE.

Notes to Implementers

An object created by an EXE object application gets keystrokes from its own message pump, so the container does not get those messages.

If you need to implement this method, you can do so by simply wrapping the call to the TranslateAccelerator function.

-see-also

IOleInPlaceActiveObject

OleTranslateAccelerator

TranslateAccelerator