Funzione OleTranslateAccelerator (ole2.h)

Articolo
03/05/2024

Chiamato dall'applicazione dell'oggetto, consente al contenitore di un oggetto di convertire gli acceleratori in base alla tabella dell'acceleratore del contenitore.

Sintassi

HRESULT OleTranslateAccelerator(
  [in] LPOLEINPLACEFRAME     lpFrame,
  [in] LPOLEINPLACEFRAMEINFO lpFrameInfo,
  [in] LPMSG                 lpmsg
);

Parametri

[in] lpFrame

Puntatore all'interfaccia IOleInPlaceFrame a cui potrebbe essere inviata la sequenza di tasti.

[in] lpFrameInfo

Puntatore a una struttura OLEINPLACEFRAMEINFO contenente la tabella dell'acceleratore ottenuta dal contenitore.

[in] lpmsg

Puntatore a una struttura MSG contenente la sequenza di tasti.

Valore restituito

Questa funzione restituisce S_OK in caso di esito positivo. Altri valori possibili includono quanto segue.

Codice restituito	Descrizione
E_FAIL	L'oggetto deve continuare a elaborare questo messaggio.

Commenti

I server oggetti chiamano OleTranslateAccelerator per consentire al contenitore dell'oggetto di convertire le sequenze di tasti di scelta rapida in base alla tabella dell'acceleratore del contenitore, a cui punta lpFrameInfo. Mentre un oggetto indipendente è l'oggetto attivo, il server dell'oggetto ha sempre la possibilità di tradurre tutti i messaggi ricevuti. Se non lo si desidera, il server chiama OleTranslateAccelerator per concedere al contenitore dell'oggetto una possibilità. Se l'input della tastiera corrisponde a un acceleratore trovato nella tabella di acceleratore fornita dal contenitore, OleTranslateAccelerator passa il messaggio e il relativo identificatore di comando al contenitore tramite il metodo IOleInPlaceFrame::TranslateAccelerator . Questo metodo restituisce S_OK se viene utilizzata la sequenza di tasti; in caso contrario restituisce S_FALSE.

Le tabelle degli acceleratori per i contenitori devono essere definite in modo che funzionino correttamente con le applicazioni oggetto che eseguono le proprie traduzioni di tasti di scelta rapida. Queste tabelle devono assumere il formato seguente:

"char", wID, VIRTKEY, CONTROL

Questo è il modo più comune per descrivere i tasti di scelta rapida. In caso contrario, è possibile che le sequenze di tasti vengano perse o inviate all'oggetto errato durante una sessione sul posto.

Gli oggetti possono chiamare la funzione IsAccelerator per verificare se la sequenza di tasti di scelta rapida appartiene all'oggetto o al contenitore.

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	ole2.h
Libreria	Ole32.lib
DLL	Ole32.dll
Set di API	ext-ms-win-com-ole32-l1-1-3 (introdotto in Windows 10, versione 10.0.10240)

Vedi anche

IOleInPlaceFrame::TranslateAccelerator

IsAccelerator

Condividi tramite