IOleControlSite::TranslateAccelerator-Methode (ocidl.h)
Ü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 |
|---|---|
|
Der Container hat die Nachricht verarbeitet. |
|
Der Container hat die Nachricht nicht verarbeitet. Dieser Wert muss auch in allen anderen Fehlerfällen außer E_NOTIMPL zurückgegeben werden. |
|
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 |