IOleInPlaceSiteWindowless ::OnDefWindowMessage, méthode (ocidl.h)

Article
03/06/2024

Appelle le traitement par défaut pour tous les messages passés à un objet.

Syntaxe

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

Paramètres

[in] msg

Identificateur du message de fenêtre fourni au conteneur par Windows.

[in] wParam

Paramètre pour le message de fenêtre fourni au conteneur par Windows.

[in] lParam

Paramètre pour le message de fenêtre fourni au conteneur par Windows.

[out] plResult

Pointeur vers le code de résultat pour le message de fenêtre.

Valeur retournée

Cette méthode retourne S_OK en cas de réussite. Les autres valeurs de retour possibles sont les suivantes.

Code de retour	Description
S_FALSE	Le traitement par défaut du conteneur pour le message de la fenêtre n'a pas été appelé. Consultez la Remarque à l'attention des implémenteurs ci-dessous.

Remarques

Un objet sans fenêtre peut appeler explicitement le traitement par défaut d’un message de fenêtre en appelant cette méthode. Un conteneur distribue des messages de fenêtre à ses objets sans fenêtre en appelant IOleInPlaceObjectWindowless ::OnWindowMessage. L’objet retourne généralement S_FALSE pour indiquer qu’il n’a pas traiter le message. Ensuite, le conteneur peut effectuer le comportement par défaut du message en appelant la fonction DefWindowProc .

Au lieu de cela, l’objet peut appeler cette méthode sur l’objet de site du conteneur pour appeler explicitement le traitement par défaut. Ensuite, l’objet peut agir seul si le conteneur ne gère pas le message.

Remarques aux implémenteurs

Le conteneur doit transmettre les messages de fenêtre suivants à sa procédure de fenêtre par défaut (la fonction DefWindowProc ) et retourner S_OK. Notez que *plResult doit contenir la valeur retournée par DefWindowProc.

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

Le conteneur peut traiter les messages de fenêtre comme lui-même et retourner S_OK ou ne rien faire et retourner S_FALSE.

WM_CONTEXTMENU
WM_HELP
WM_SETCURSOR

Si le conteneur retourne S_FALSE, l’objet peut prendre des mesures pour traiter le message de fenêtre lui-même.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ocidl.h

Voir aussi

IOleInPlaceObjectWindowless ::OnWindowMessage

IOleInPlaceSiteWindowless

Partager via