IMenuBand::TranslateMenuMessage-Methode (shobjidl_core.h)

Artikel
08/26/2023

Ü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

Freigeben über