Metodo IOleControlSite::TranslateAccelerator (ocidl.h)

Passa una sequenza di tasti al sito di controllo per l'elaborazione.

Sintassi

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

Parametri

[in] pMsg

Puntatore alla struttura MSG che descrive la sequenza di tasti da elaborare.

[in] grfModifiers

Flag che descrivono lo stato dei tasti Control, Alt e Maiusc. Il valore del flag può essere qualsiasi valore di enumerazione KEYMODIFIERS valido.

Valore restituito

Questo metodo può restituire i valori seguenti.

Codice restituito	Descrizione
S_OK	Il contenitore ha elaborato il messaggio.
S_FALSE	Il contenitore non ha elaborato il messaggio. Questo valore deve essere restituito anche in tutti gli altri casi di errore oltre a E_NOTIMPL.
E_NOTIMPL	Il contenitore non implementa il supporto dell'acceleratore.

Commenti

Questo metodo viene chiamato da un controllo che può essere attivo dall'interfaccia utente. In questi casi, un controllo può elaborare prima tutte le sequenze di tasti tramite IOleInPlaceActiveObject::TranslateAccelerator, in base alle normali regole del documento composto OLE. All'interno di tale metodo, il controllo può assegnare al contenitore determinati messaggi da elaborare prima chiamando IOleControlSite::TranslateAccelerator e usando il valore restituito per determinare se è stata eseguita un'elaborazione. In caso contrario, il controllo elabora sempre il messaggio per primo. Se il controllo non usa la sequenza di tasti come acceleratore, passa la sequenza di tasti al contenitore tramite questo metodo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ocidl.h

Vedi anche

IOleControlSite

IOleInPlaceActiveObject::TranslateAccelerator