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 :
Valeur | Signification |
---|---|
|
Le membre hbm est valide. |
|
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.) |
|
Le membre fmt est valide. |
|
Les membres type et pvFilter sont valides. Il est utilisé pour filtrer les valeurs spécifiées dans le membre de type . |
|
Identique à HDI_WIDTH. |
|
Le membre iImage est valide et spécifie l’image à afficher avec l’élément. |
|
Le membre lParam est valide. |
|
Le membre iOrder est valide et spécifie la valeur de commande de l’élément. |
|
Version 6.00 et ultérieures. Le membre d’état est valide. |
|
Les membres pszText et cchTextMax sont valides. |
|
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 |
---|---|
|
Définissez l’un des indicateurs suivants pour spécifier la justification du texte : |
|
Le contenu de l’élément est centré. |
|
Le contenu de l’élément est aligné à gauche. |
|
Le contenu de l’élément est aligné à droite. |
|
Définissez l’un des indicateurs suivants pour contrôler l’affichage : |
|
L’élément affiche une bitmap. |
|
La bitmap apparaît à droite du texte. |
|
Le propriétaire du contrôle d’en-tête dessine l’élément. |
|
L’élément affiche une chaîne. |
|
La valeur précédente peut être combinée avec : |
|
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. |
|
Isolez les bits correspondant aux trois indicateurs de justification répertoriés dans le tableau précédent. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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 |
---|---|
|
Données de chaîne. |
|
Données numériques. |
|
Ignorez pvFilter. |
|
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 |
---|---|
|
L’élément a le focus clavier. |
Remarques
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 |