IOleControlSite::TranslateAccelerator-Methode (ocidl.h)

Artikel
08/25/2023

Übergibt zur Verarbeitung eine Tastatureingabe an den Steuerelementstandort.

Syntax

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

Parameter

[in] pMsg

Ein Zeiger auf die MSG-Struktur , die die zu verarbeitende Tastatureingabe beschreibt.

[in] grfModifiers

Flags, die den Zustand der Tasten "Steuerelement", "ALT" und "UMSCHALT" beschreiben. Der Wert des Flags kann beliebige gültige KEYMODIFIERS-Enumerationswerte sein.

Rückgabewert

Diese Methode kann die folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Der Container hat die Nachricht verarbeitet.
S_FALSE	Der Container hat die Nachricht nicht verarbeitet. Dieser Wert muss auch in allen anderen Fehlerfällen außer E_NOTIMPL zurückgegeben werden.
E_NOTIMPL	Der Container implementiert keine Unterstützung für zugriffsbeschleunigung.

Hinweise

Diese Methode wird von einem Steuerelement aufgerufen, das ui-aktiv sein kann. In solchen Fällen kann ein Steuerelement alle Tastatureingaben zuerst über IOleInPlaceActiveObject::TranslateAccelerator gemäß den normalen REGELN für OLE-Verbunddokument verarbeiten. Innerhalb dieser Methode kann das Steuerelement dem Container bestimmte Meldungen bereitstellen, die zuerst verarbeitet werden sollen, indem IOleControlSite::TranslateAccelerator aufgerufen und der Rückgabewert verwendet wird, um zu bestimmen, ob eine Verarbeitung erfolgt ist. Andernfalls verarbeitet das Steuerelement die Nachricht immer zuerst. Wenn das Steuerelement die Tastatureingabe nicht als Beschleuniger verwendet, übergibt es die Tastatureingabe über diese Methode an den Container.

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

Weitere Informationen

IOleControlSite

IOleInPlaceActiveObject::TranslateAccelerator

Share via