OleTranslateAccelerator-Funktion (ole2.h)

  • Artikel

Wird von der Objektanwendung aufgerufen, kann der Container eines Objekts Beschleuniger entsprechend der Beschleunigertabelle des Containers übersetzen.

Syntax

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

Parameter

[in] lpFrame

Zeiger auf die IOleInPlaceFrame-Schnittstelle , an die die Tastatureingabe möglicherweise gesendet wird.

[in] lpFrameInfo

Zeiger auf eine OLEINPLACEFRAMEINFO-Struktur , die die aus dem Container abgerufene Zugriffstastentabelle enthält.

[in] lpmsg

Zeiger auf eine MSG-Struktur , die die Tastatureingabe enthält.

Rückgabewert

Diese Funktion gibt S_OK nach Erfolg zurück. Weitere mögliche Werte sind:

Rückgabecode Beschreibung
E_FAIL
 Das -Objekt sollte mit der Verarbeitung dieser Nachricht fortfahren.

Hinweise

Objektserver rufen OleTranslateAccelerator auf, damit der Container des Objekts Beschleunigertasteneingaben gemäß der Beschleunigertabelle des Containers übersetzen kann, auf die von lpFrameInfo verwiesen wird. Während ein eigenständiges Objekt das aktive Objekt ist, hat der Server des Objekts immer die erste Chance, empfangene Nachrichten zu übersetzen. Wenn dies nicht gewünscht ist, ruft der Server OleTranslateAccelerator auf, um dem Container des Objekts eine Chance zu geben. Wenn die Tastatureingabe mit einem Beschleuniger übereinstimmt, der in der vom Container bereitgestellten Beschleunigertabelle gefunden wurde, übergibt OleTranslateAccelerator die Nachricht und den zugehörigen Befehlsbezeichner an den Container über die IOleInPlaceFrame::TranslateAccelerator-Methode . Diese Methode gibt S_OK zurück, wenn die Tastatureingabe verwendet wird. Andernfalls wird S_FALSE zurückgegeben.

Zugriffstastentabellen für Container sollten definiert werden, damit sie ordnungsgemäß mit Objektanwendungen funktionieren, die ihre eigenen Tastenkombinationsübersetzungen durchführen. Diese Tabellen sollten folgende Form annehmen:

"char", wID, VIRTKEY, CONTROL

Dies ist die am häufigsten verwendete Methode zum Beschreiben von Tastenkombinationen. Andernfalls können Tastaturanschläge während einer direkten Sitzung verloren gehen oder an das falsche Objekt gesendet werden.

Objekte können die IsAccelerator-Funktion aufrufen, um festzustellen, ob die Tastenkombination zum Objekt oder container gehört.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ole2.h
Bibliothek Ole32.lib
DLL Ole32.dll
APIs ext-ms-win-com-ole32-l1-1-3 (eingeführt in Windows 10, Version 10.0.10240)

Weitere Informationen

IOleInPlaceFrame::TranslateAccelerator

IsAccelerator