Structure HDITEMA (commctrl.h)

  • Article

Contient des informations sur un élément dans un contrôle d’en-tête. Cette structure remplace la structure HD_ITEM .

Syntaxe

typedef struct _HD_ITEMA {
  UINT    mask;
  int     cxy;
  LPSTR   pszText;
  HBITMAP hbm;
  int     cchTextMax;
  int     fmt;
  LPARAM  lParam;
  int     iImage;
  int     iOrder;
  UINT    type;
  void    *pvFilter;
  UINT    state;
} HDITEMA, *LPHDITEMA;

Membres

mask

Type : UINT

Indicateurs indiquant quels autres membres de structure contiennent des données valides ou doivent être renseignés. Ce membre peut être une combinaison des valeurs suivantes :

Valeur Signification
HDI_BITMAP
 Le membre hbm est valide.
HDI_DI_SETITEM
 Lors de la gestion du message HDM_GETITEM, le contrôle d’en-tête peut ne pas avoir toutes les valeurs nécessaires pour terminer la demande. Dans ce cas, le contrôle doit rappeler l’application pour les valeurs via la notification HDN_GETDISPINFO . Si HDI_DI_SETITEM a été passé dans le message HDM_GETITEM , le contrôle met en cache toutes les valeurs retournées par HDN_GETDISPINFO (sinon, les valeurs restent non définies.)
HDI_FORMAT
 Le membre fmt est valide.
HDI_FILTER
 Les membres type et pvFilter sont valides. Il est utilisé pour filtrer les valeurs spécifiées dans le membre de type .
HDI_HEIGHT
 Identique à HDI_WIDTH.
HDI_IMAGE
 Le membre iImage est valide et spécifie l’image à afficher avec l’élément.
HDI_LPARAM
 Le membre lParam est valide.
HDI_ORDER
 Le membre iOrder est valide et spécifie la valeur de commande de l’élément.
HDI_STATE

Version 6.00 et ultérieures. Le membre d’état est valide.
HDI_TEXT
 Les membres pszText et cchTextMax sont valides.
HDI_WIDTH
 Le membre cxy est valide et spécifie la largeur de l’élément.

cxy

Type : int

Largeur ou hauteur de l’élément.

pszText

Type : LPTSTR

Pointeur vers une chaîne d’élément. Si le texte est récupéré à partir du contrôle, ce membre doit être initialisé pour pointer vers une mémoire tampon de caractères. Si ce membre est défini sur LPSTR_TEXTCALLBACK, le contrôle demande des informations de texte pour cet élément en envoyant un code de notification HDN_GETDISPINFO . Notez que bien que le contrôle d’en-tête autorise le stockage d’une chaîne de n’importe quelle longueur en tant que texte d’élément, seuls les 260 premiers TCHAR s’affichent.

hbm

Type : HBITMAP

Handle de l’élément bitmap.

cchTextMax

Type : int

Longueur de la chaîne d’élément, en TCHAR. Si le texte est récupéré à partir du contrôle, ce membre doit contenir le nombre de TCHARà l’adresse spécifiée par pszText.

fmt

Type : int

Indicateurs qui spécifient le format de l’élément.

Valeur Signification
Justification du texte :
 Définissez l’un des indicateurs suivants pour spécifier la justification du texte :
HDF_CENTER
 Le contenu de l’élément est centré.
HDF_LEFT
 Le contenu de l’élément est aligné à gauche.
HDF_RIGHT
 Le contenu de l’élément est aligné à droite.
Affichage :
 Définissez l’un des indicateurs suivants pour contrôler l’affichage :
HDF_BITMAP
 L’élément affiche une bitmap.
HDF_BITMAP_ON_RIGHT
 La bitmap apparaît à droite du texte.
HDF_OWNERDRAW
 Le propriétaire du contrôle d’en-tête dessine l’élément.
HDF_STRING
 L’élément affiche une chaîne.
Combinaison d’indicateurs :
 La valeur précédente peut être combinée avec :
HDF_IMAGE
 Afficher une image à partir d’une liste d’images. Spécifiez la liste d’images en envoyant un message HDM_SETIMAGELIST . Spécifiez l’index de l’image dans le membre iImage de cette structure.
HDF_JUSTIFYMASK
 Isolez les bits correspondant aux trois indicateurs de justification répertoriés dans le tableau précédent.
HDF_RTLREADING
 En règle générale, windows affiche du texte de gauche à droite (LTR). Windows peut être mis en miroir pour afficher des langues telles que l’hébreu ou l’arabe qui lisent de droite à gauche (RTL). En règle générale, le texte d’en-tête est lu dans la même direction que le texte de sa fenêtre parente. Si HDF_RTLREADING est défini, le texte d’en-tête est lu dans la direction opposée du texte de la fenêtre parente.
HDF_SORTDOWN

Version 6.00 et ultérieures. Dessine une flèche vers le bas sur cet élément. Ceci est généralement utilisé pour indiquer que les informations de la fenêtre active sont triées sur cette colonne dans l’ordre décroissant. Cet indicateur ne peut pas être combiné avec HDF_IMAGE ou HDF_BITMAP.
HDF_SORTUP

Version 6.00 et ultérieures. Dessine une flèche vers le haut sur cet élément. Ceci est généralement utilisé pour indiquer que les informations de la fenêtre active sont triées sur cette colonne dans l’ordre croissant. Cet indicateur ne peut pas être combiné avec HDF_IMAGE ou HDF_BITMAP.
HDF_CHECKBOX

Version 6.00 et ultérieures. L’élément affiche une case à cocher. L’indicateur n’est valide que lorsque le style HDS_CHECKBOXES est défini pour la première fois sur le contrôle d’en-tête.
HDF_CHECKED

Version 6.00 et ultérieures. L’élément affiche une case à cocher cochée. L’indicateur n’est valide que lorsque HDF_CHECKBOX est également défini.
HDF_FIXEDWIDTH

Version 6.00 et ultérieures. La largeur de l’élément ne peut pas être modifiée par une action de l’utilisateur pour le redimensionner.
HDF_SPLITBUTTON

Version 6.00 et ultérieures. L’élément affiche un bouton fractionné. La notification HDN_DROPDOWN est envoyée lorsque l’utilisateur clique sur le bouton fractionné.

lParam

Type : LPARAM

Données d’élément définies par l’application.

iImage

Type : int

Index de base zéro d’une image dans la liste d’images. L’image spécifiée s’affiche dans l’élément d’en-tête en plus de toute image spécifiée dans le champ hbm . Si iImage est défini sur I_IMAGECALLBACK, le contrôle demande des informations de texte pour cet élément à l’aide d’un code de notification HDN_GETDISPINFO . Pour effacer l’image, définissez cette valeur sur I_IMAGENONE.

iOrder

Type : int

Ordre dans lequel l’élément apparaît dans le contrôle d’en-tête, de gauche à droite. Autrement dit, la valeur de l’élément à l’extrême gauche est 0. La valeur de l’élément suivant à droite est 1, et ainsi de suite.

type

Type : UINT

Type de filtre spécifié par pvFilter. Les types possibles sont les suivants :

Valeur Signification
HDFT_ISSTRING
 Données de chaîne.
HDFT_ISNUMBER
 Données numériques.
HDFT_HASNOVALUE
 Ignorez pvFilter.
HDFT_ISDATE

Version 6.00 et ultérieures. Données de date. Le membre pvFilter est un pointeur vers une structure SYSTEMTIME .

pvFilter

Type : void*

Adresse d’un élément de données défini par l’application. Le type de filtre de données est déterminé en définissant la valeur d’indicateur du membre. Utilisez l’indicateur HDFT_ISSTRING pour indiquer une chaîne et HDFT_ISNUMBER pour indiquer un entier. Lorsque l’indicateur HDFT_ISSTRING est utilisé , pvFilter est un pointeur vers une structure HDTEXTFILTER .

state

Type : UINT

État. La seule valeur valide et prise en charge pour ce membre est la suivante :

Valeur Signification
HDIS_FOCUSED
 L’élément a le focus clavier.

Remarques

Notez Comctl32.dll version 6 n’est pas redistribuable, mais elle est incluse dans Windows. Pour utiliser Comctl32.dll version 6, spécifiez-la dans un manifeste. Pour plus d’informations sur les manifestes, consultez Activation des styles visuels.
 

Notes

L’en-tête commctrl.h définit HDITEM en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
En-tête commctrl.h