IMenuBand::TranslateMenuMessage-Methode (shobjidl_core.h)

  • Artikel

Übersetzt eine Nachricht für ein COM-Objekt (Component Object Model).

Syntax

HRESULT TranslateMenuMessage(
  [in, out] MSG     *pmsg,
  [out]     LRESULT *plRet
);

Parameter

[in, out] pmsg

Typ: MSG*

Ein Zeiger auf eine MSG-Struktur , die die eingehende Nachricht enthält.

[out] plRet

Typ: LRESULT*

Ein Zeiger auf die übersetzte Nachricht.

Rückgabewert

Typ: HRESULT

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Die Nachricht wurde verarbeitet und sollte gelöscht werden.
S_FALSE
 Die Nachricht wurde nicht verarbeitet. In diesem Fall ist *plRet NULL.

Hinweise

In der Regel wird IMenuBand::IsMenuMessage vor dieser Methode aufgerufen. Das übergeordnete Fenster proc, nicht die Nachrichtenpumpe, muss für jede Nachricht IMenuBand::TranslateMenuMessage aufrufen.

Diese Methode kann die Werte von pmsg ändern. Wenn ja, sollten die Änderungen weitergeleitet werden.

Diese Methode ist erforderlich, da einige modale Nachrichtenpumpen keinen Aufruf einer benutzerdefinierten Übersetzungsmethode zulassen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (einschließlich Shobjidl.h)
DLL Shell32.dll