Méthode IShellBrowser ::SendControlMsg (shobjidl_core.h)

Article
08/26/2023

Envoie des messages de contrôle à la barre d’outils ou à la barre d’status dans une fenêtre windows Explorer.

Syntaxe

HRESULT SendControlMsg(
  UINT    id,
  UINT    uMsg,
  WPARAM  wParam,
  LPARAM  lParam,
  LRESULT *pret
);

Paramètres

id

Type : UINT

Identificateur d’une barre d’outils (FCW_TOOLBAR) ou d’une fenêtre de barre d’status (FCW_STATUS).

uMsg

Type : UINT

Message à envoyer au contrôle.

wParam

Type : WPARAM

La valeur dépend du message spécifié dans le paramètre uMsg .

lParam

Type : LPARAM

La valeur dépend du message spécifié dans le paramètre uMsg .

pret

Type : LRESULT*

Adresse de la valeur de retour de la fonction SendMessage .

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite, ou une valeur d’erreur définie par COM dans le cas contraire.

Remarques

Pour plus d’informations sur les messages qui peuvent être envoyés à la barre d’outils ou à status contrôle de barre d’outils, reportez-vous à la documentation Sur les contrôles communs.

Remarques relatives à l’appel d’applications

L’utilisation de cet appel nécessite une attention diligente, car le fait de laisser la barre d’status ou la barre d’outils dans un état inapproprié affectera les performances de Windows Explorer.

Notes aux implémenteurs

Si votre Explorer Windows ne dispose pas de ces contrôles, vous pouvez retourner E_NOTIMPL.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (inclure Shobjidl.h)
DLL	Shell32.dll (version 4.0 ou ultérieure)

Voir aussi

IShellBrowser

Partager via