Structure DESKBANDINFO (shobjidl_core.h)

Reçoit des informations sur un objet de bande. Cette structure est utilisée avec la méthode IDeskBand ::GetBandInfo dépréciée.

Syntaxe

typedef struct DESKBANDINFO {
  DWORD    dwMask;
  POINTL   ptMinSize;
  POINTL   ptMaxSize;
  POINTL   ptIntegral;
  POINTL   ptActual;
  WCHAR    wszTitle[256];
  DWORD    dwModeFlags;
  COLORREF crBkgnd;
} DESKBANDINFO;

Membres

dwMask

Type : DWORD

Ensemble d’indicateurs qui déterminent les membres de cette structure qui sont demandés par l’appelant. Une ou plusieurs des valeurs suivantes :

DBIM_MINSIZE

ptMinSize est demandé.

DBIM_MAXSIZE

ptMaxSize est demandé.

DBIM_INTEGRAL

ptIntegral est demandé.

DBIM_ACTUAL

ptActual est demandé.

DBIM_TITLE

wszTitle est demandé.

DBIM_MODEFLAGS

dwModeFlags est demandé.

DBIM_BKCOLOR

crBkgnd est demandé.

ptMinSize

Type : POINTL

Structure POINTL qui reçoit la taille minimale de l’objet de bande. La largeur minimale est indiquée dans le membre x de la structure POINTL et la hauteur minimale est indiquée dans le membre y.

ptMaxSize

Type : POINTL

Structure POINTL qui reçoit la taille maximale de l’objet de bande. La hauteur maximale est indiquée dans le membre y de la structure POINTL et le membre x est ignoré. Si l’objet de bande n’a pas de limite pour sa hauteur maximale, (LONG)-1 doit être utilisé.

ptIntegral

Type : POINTL

Structure POINTL qui reçoit la valeur de l’étape de dimensionnement (incrément) dans laquelle l’objet de bande est redimensionné. La valeur de l’étape verticale est donnée dans le membre y de la structure POINTL et le membre x est ignoré.

Le membre dwModeFlags doit contenir l’indicateur DBIMF_VARIABLEHEIGHT ; sinon, ptIntegral est ignoré.

ptActual

Type : POINTL

Structure POINTL qui reçoit la taille idéale de l’objet de bande. La largeur idéale est donnée dans le membre x de la structure POINTL et la hauteur idéale est donnée dans le membre y. Le conteneur de bandes tente d’utiliser ces valeurs, mais il n’est pas garanti que la bande ait cette taille.

wszTitle[256]

Type : WCHAR[256]

Mémoire tampon WCHAR qui reçoit le titre du groupe.

dwModeFlags

Type : DWORD

Valeur qui reçoit un ensemble d’indicateurs qui spécifient le mode de fonctionnement de l’objet band. Une ou plusieurs des valeurs suivantes :

DBIMF_NORMAL

La bande utilise les propriétés par défaut. Les autres indicateurs de mode modifient cet indicateur.

DBIMF_FIXED

Windows XP et versions ultérieures : L’objet de bande est d’une taille et d’une position fixes. Avec cet indicateur, une poignée de dimensionnement n’est pas affichée sur l’objet bande.

DBIMF_FIXEDBMP

Windows XP et versions ultérieures : L’objet band utilise un fichier bitmap fixe (.bmp) comme arrière-plan. Notez que les arrière-plans ne sont pas pris en charge dans tous les cas, de sorte que la bitmap peut ne pas être visible même lorsque cet indicateur est défini.

DBIMF_VARIABLEHEIGHT

La hauteur de l’objet de bande peut être modifiée. Le membre ptIntegral définit la valeur d’étape par laquelle l’objet de bande peut être redimensionné.

DBIMF_UNDELETEABLE

Windows XP et versions ultérieures : L’objet band ne peut pas être supprimé du conteneur de bandes.

DBIMF_DEBOSSED

L’objet band est affiché avec une apparence enfoncée.

DBIMF_BKCOLOR

La bande s’affiche avec la couleur d’arrière-plan spécifiée dans crBkgnd.

DBIMF_USECHEVRON

Windows XP et versions ultérieures : Si l’objet de bande complète ne peut pas être affiché (autrement dit, l’objet de bande est plus petit que ptActual, un chevron est affiché pour indiquer qu’il existe davantage d’options disponibles. Ces options s’affichent lorsque l’utilisateur clique sur le chevron.

DBIMF_BREAK

Windows XP et versions ultérieures : L’objet band s’affiche dans une nouvelle ligne dans le conteneur de bandes.

DBIMF_ADDTOFRONT

Windows XP et versions ultérieures : L’objet band est le premier objet dans le conteneur de bandes.

DBIMF_TOPALIGN

Windows XP et versions ultérieures : L’objet band s’affiche dans la ligne supérieure du conteneur de bandes.

DBIMF_NOGRIPPER

Windows Vista et versions ultérieures : Aucune poignée de dimensionnement n’est jamais affichée pour permettre à l’utilisateur de déplacer ou de redimensionner l’objet bande.

DBIMF_ALWAYSGRIPPER

Windows Vista et versions ultérieures : Une poignée de dimensionnement qui permet à l’utilisateur de déplacer ou de redimensionner l’objet de bande est toujours affichée, même si cet objet de bande est le seul dans le conteneur.

DBIMF_NOMARGINS

Windows Vista et versions ultérieures : L’objet band ne doit pas afficher de marges.

crBkgnd

Type : COLORREF

Structure COLORREF qui reçoit la couleur d’arrière-plan de la bande. Le membre dwModeFlags doit contenir l’indicateur DBIMF_BKCOLOR ; sinon, crBkgnd est ignoré.

Configuration requise

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]
En-tête	shobjidl_core.h (incluez Shobjidl.h)