Freigeben über

IOleInPlaceSiteWindowless::OnDefWindowMessage-Methode (ocidl.h)

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

  • Last updated on