Método IOleControlSite::TranslateAccelerator (ocidl.h)

  • Artículo

Pasa una pulsación de tecla al sitio de control para su procesamiento.

Sintaxis

HRESULT TranslateAccelerator(
  [in] MSG   *pMsg,
  [in] DWORD grfModifiers
);

Parámetros

[in] pMsg

Puntero a la estructura msg que describe la pulsación de tecla que se va a procesar.

[in] grfModifiers

Marcas que describen el estado de las teclas Control, Alt y Mayús. El valor de la marca puede ser cualquier valor de enumeración KEYMODIFIERS válido.

Valor devuelto

Este método puede devolver los siguientes valores.

Código devuelto Descripción
S_OK
 El contenedor procesó el mensaje.
S_FALSE
 El contenedor no procesó el mensaje. Este valor también se debe devolver en todos los demás casos de error además de E_NOTIMPL.
E_NOTIMPL
 El contenedor no implementa compatibilidad con el acelerador.

Comentarios

Un control que puede ser activo en la interfaz de usuario llama a este método. En tales casos, un control puede procesar primero todas las pulsaciones de tecla a través de IOleInPlaceActiveObject::TranslateAccelerator, según las reglas normales del documento compuesto OLE. Dentro de ese método, el control puede proporcionar al contenedor determinados mensajes que procesar primero llamando a IOleControlSite::TranslateAccelerator y usando el valor devuelto para determinar si se produjo algún procesamiento. De lo contrario, el control siempre procesa el mensaje primero. Si el control no usa la pulsación de tecla como acelerador, pasa la pulsación de tecla al contenedor a través de este método.

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 ocidl.h

Consulte también

IOleControlSite

IOleInPlaceActiveObject::TranslateAccelerator