Método IOleInPlaceActiveObject::TranslateAccelerator (oleidl.h)

  • Artículo

Procesa los mensajes de tecla de aceleración del menú de la cola de mensajes del contenedor. Este método solo se debe usar para los objetos creados por una aplicación de objetos DLL.

Sintaxis

HRESULT TranslateAccelerator(
  [in] LPMSG lpmsg
);

Parámetros

[in] lpmsg

Puntero a una estructura MSG para el mensaje que podría necesitar traducirse.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente. Otros posibles valores devueltos son los siguientes.

Código devuelto Descripción
S_FALSE
 El mensaje no se traducía.
E_INVALIDARG
 Los valores de parámetro especificados no son válidos.
E_OUTOFMEMORY
 IThere no tiene suficiente memoria disponible para la operación.
E_UNEXPECTED
 Se produjo un error inesperado.

Comentarios

Notas a los autores de llamadas

Los objetos activos en contexto siempre deben tener la primera oportunidad de traducir pulsaciones de tecla del acelerador. Puede proporcionar esta oportunidad llamando a IOleInPlaceActiveObject::TranslateAccelerator desde el bucle de mensajes del contenedor antes de realizar cualquier otra traducción. Solo debe aplicar su propia traducción cuando este método devuelve S_FALSE.

Si llama a IOleInPlaceActiveObject::TranslateAccelerator para un objeto que no se crea mediante una aplicación de objeto DLL, el controlador de objetos predeterminado devuelve S_FALSE.

Notas para los implementadores

Un objeto creado por una aplicación de objetos EXE obtiene pulsaciones de teclas de su propia bomba de mensajes, por lo que el contenedor no obtiene esos mensajes.

Si necesita implementar este método, puede hacerlo simplemente ajustando la llamada a la función TranslateAccelerator .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado oleidl.h

Consulte también

IOleInPlaceActiveObject

OleTranslateAccelerator

TranslateAccelerator