IOleInPlaceSiteWindowless::OnDefWindowMessage-Methode (ocidl.h)

Artikel
08/25/2023

Ruft die Standardverarbeitung für alle Nachrichten auf, die einem Objekt übergeben werden.

Syntax

HRESULT OnDefWindowMessage(
  [in]  UINT    msg,
  [in]  WPARAM  wParam,
  [in]  LPARAM  lParam,
  [out] LRESULT *plResult
);

Parameter

[in] msg

Der Bezeichner für die Fenstermeldung, die dem Container von Windows bereitgestellt wurde.

[in] wParam

Ein Parameter für die Fenstermeldung, die dem Container von Windows bereitgestellt wird.

[in] lParam

Ein Parameter für die Fenstermeldung, die dem Container von Windows bereitgestellt wird.

[out] plResult

Ein Zeiger auf Ergebniscode für die Fenstermeldung.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:

Rückgabecode	Beschreibung
S_FALSE	Der Standardverarbeitung für die Fenstermeldung wurde nicht aufgerufen. Siehe Hinweis zu den Implementierern unten.

Hinweise

Ein fensterloses Objekt kann die Standardverarbeitung für eine Fensternachricht explizit aufrufen, indem diese Methode aufgerufen wird. Ein Container sendet Fensternachrichten an seine fensterlosen Objekte, indem er IOleInPlaceObjectWindowless::OnWindowMessage aufruft. Das -Objekt gibt normalerweise S_FALSE zurück, um anzugeben, dass es die Nachricht nicht verarbeitet hat. Anschließend kann der Container das Standardverhalten für die Nachricht ausführen, indem die Funktion DefWindowProc aufgerufen wird.

Stattdessen kann das -Objekt diese Methode im Standortobjekt des Containers aufrufen, um die Standardverarbeitung explizit aufzurufen. Anschließend kann das -Objekt eine eigene Aktion ausführen, wenn der Container die Nachricht nicht verarbeitet.

Hinweise zu Implementierern

Der Container muss die folgenden Fenstermeldungen an seine Standardfensterprozedur (die DefWindowProc-Funktion ) übergeben und S_OK zurückgeben. Beachten Sie, dass *plResult den von DefWindowProc zurückgegebenen Wert enthalten sollte.

WM_CHAR
WM_DEADCHAR
WM_IMExxx
WM_KEYDOWN
WM_KEYUP
WM_MOUSEMOVE
WM_SYSCHAR
WM_SYSDEADCHAR
WM_SYSKEYUP
WM_XBUTTONDOWN
WM_XBUTTONUP
WM_XBUTTONDBLCLK

Der Container kann entweder die Fensternachrichten als eigene verarbeiten und S_OK zurückgeben oder nichts tun und S_FALSE zurückgeben.

WM_CONTEXTMENU
WM_HELP
WM_SETCURSOR

Wenn der Container S_FALSE zurückgibt, kann das Objekt Aktionen ergreifen, um die Fensternachricht selbst zu verarbeiten.

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

IOleInPlaceObjectWindowless::OnWindowMessage

IOleInPlaceSiteWindowless