Funzione OleTranslateAccelerator (ole2.h)
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 |
---|---|
|
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) |