Méthode IDeskBand ::GetBandInfo (shobjidl_core.h)

Article
03/02/2024

Obtient des informations d’état pour un objet de bande.

Important Vous devez utiliser des barres d’outils miniatures dans le nouveau développement à la place des bandes de bureau, qui ne sont pas prises en charge à partir de Windows 7.

Syntaxe

HRESULT GetBandInfo(
  DWORD        dwBandID,
  DWORD        dwViewMode,
  DESKBANDINFO *pdbi
);

Paramètres

dwBandID

Type : DWORD

Identificateur de la bande, attribué par le conteneur. L’objet band peut conserver cette valeur si nécessaire.

dwViewMode

Type : DWORD

Mode d’affichage de l’objet band. Une des valeurs suivantes :

DBIF_VIEWMODE_NORMAL

L’objet band est affiché dans une bande horizontale.

DBIF_VIEWMODE_VERTICAL

L’objet band est affiché dans une bande verticale.

DBIF_VIEWMODE_FLOATING

L’objet band est affiché dans une bande flottante.

DBIF_VIEWMODE_TRANSPARENT

L’objet band est affiché dans une bande transparente.

pdbi

Type : DESKBANDINFO*

Pointeur vers une structure DESKBANDINFO qui reçoit les informations de bande pour l’objet . Le membre dwMask de cette structure indique les informations spécifiques demandées.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel, 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 Shlobj.h)
DLL	Shell32.dll (version 4.71 ou ultérieure)

Partager via