IsAccelerator-Funktion (ole2.h)

  • Artikel

Bestimmt, ob die angegebene Tastenkombination einem Beschleuniger in der angegebenen Zugriffstastentabelle zugeordnet wird.

Syntax

BOOL IsAccelerator(
  [in]  HACCEL hAccel,
  [in]  int    cAccelEntries,
  [in]  LPMSG  lpMsg,
  [out] WORD   *lpwCmd
);

Parameter

[in] hAccel

Ein Handle für die Zugriffstastentabelle.

[in] cAccelEntries

Die Anzahl der Einträge in der Zugriffstastentabelle.

[in] lpMsg

Ein Zeiger auf die zu übersetzende Tastaturmeldung.

[out] lpwCmd

Ein Zeiger auf eine Variable, um den entsprechenden Befehlsbezeichner zu empfangen, wenn ein Beschleuniger für die Tastatureingabe vorhanden ist. Dieser Parameter kann NULL sein.

Rückgabewert

Wenn die Meldung für die Objektanwendung gilt, ist der Rückgabewert TRUE. Wenn die Nachricht nicht für das Objekt gilt und an den Container weitergeleitet werden soll, ist der Rückgabewert FALSE.

Hinweise

Während ein Objekt direkt aktiv ist, hat das Objekt immer die erste Chance, die Tastenanschläge in Beschleuniger zu übersetzen. Wenn die Tastatureingabe einem seiner Beschleuniger entspricht, darf das Objekt die OleTranslateAccelerator-Funktion nicht aufrufen, auch wenn der Aufruf der TranslateAccelerator-Funktion fehlschlägt. Wenn Tastaturanschläge nicht auf diese Weise verarbeitet werden, kann dies zu inkonsistentem Verhalten führen.

Wenn die Tastatureingabe keine der Beschleuniger des Objekts ist, muss das Objekt OleTranslateAccelerator aufrufen, damit der Container seine Beschleunigerübersetzung ausprobieren kann.

Der Server des Objekts kann IsAccelerator aufrufen, um zu bestimmen, ob die Acceleratormeldung dazu gehört. Einige Server führen die Beschleunigungsübersetzung selbst durch und rufen TranslateAccelerator nicht auf. Diese Anwendungen rufen IsAccelerator nicht auf, da sie bereits über die Informationen verfügen.

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

Weitere Informationen

OleTranslateAccelerator

TranslateAccelerator