Metodo IOleInPlaceActiveObject::TranslateAccelerator (oleidl.h)

Articolo
03/05/2024

Elabora i messaggi di tasti di scelta rapida del menu dalla coda dei messaggi del contenitore. Questo metodo deve essere usato solo per gli oggetti creati da un'applicazione oggetto DLL.

Sintassi

HRESULT TranslateAccelerator(
  [in] LPMSG lpmsg
);

Parametri

[in] lpmsg

Puntatore a una struttura MSG per il messaggio che potrebbe essere necessario tradurre.

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:

Codice restituito	Descrizione
S_FALSE	Il messaggio non è stato tradotto.
E_INVALIDARG	I valori dei parametri specificati non sono validi.
E_OUTOFMEMORY	IThere è insufficiente memoria disponibile per l'operazione.
E_UNEXPECTED	Si è verificato un errore imprevisto.

Commenti

Note ai chiamanti

Gli oggetti sul posto attivi devono sempre avere la prima possibilità di tradurre le sequenze di tasti di scelta rapida. È possibile fornire questa opportunità chiamando IOleInPlaceActiveObject::TranslateAccelerator dal ciclo di messaggi del contenitore prima di eseguire qualsiasi altra traduzione. È consigliabile applicare la traduzione personalizzata solo quando questo metodo restituisce S_FALSE.

Se si chiama IOleInPlaceActiveObject::TranslateAccelerator per un oggetto non creato da un'applicazione oggetto DLL, il gestore oggetti predefinito restituisce S_FALSE.

Note per gli implementatori

Un oggetto creato da un'applicazione oggetto EXE ottiene le sequenze di tasti dal proprio message pump, in modo che il contenitore non ottenga tali messaggi.

Se è necessario implementare questo metodo, è possibile eseguire questa operazione eseguendo semplicemente il wrapping della chiamata alla funzione TranslateAccelerator .

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