Structure HDITEMW (commctrl.h)

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_ITEMW {
  UINT    mask;
  int     cxy;
  LPWSTR  pszText;
  HBITMAP hbm;
  int     cchTextMax;
  int     fmt;
  LPARAM  lParam;
  int     iImage;
  int     iOrder;
  UINT    type;
  void    *pvFilter;
  UINT    state;
} HDITEMW, *LPHDITEMW;

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 :

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 textuelles pour cet élément en envoyant un code de notification HDN_GETDISPINFO. Notez que bien que le contrôle d’en-tête autorise une chaîne de toute longueur à stocker en tant que texte d’élément, seuls les 260 premiers TCHARs sont affichés.

hbm

Type : HBITMAP

Handle de l’image bitmap de l’élément.

cchTextMax

Type : int

Longueur de la chaîne d’élément, dans 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.

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 d’une image spécifiée dans le champ hbm. Si iImage est défini sur I_IMAGECALLBACK, le contrôle demande des informations textuelles 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 d’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 :

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 prise en charge pour ce membre est la suivante :

Remarques

Exigences