Structure LVGROUP (commctrl.h)

Utilisé pour définir et récupérer des groupes.

Syntaxe

typedef struct tagLVGROUP {
  UINT   cbSize;
  UINT   mask;
  LPWSTR pszHeader;
  int    cchHeader;
  LPWSTR pszFooter;
  int    cchFooter;
  int    iGroupId;
  UINT   stateMask;
  UINT   state;
  UINT   uAlign;
  LPWSTR pszSubtitle;
  UINT   cchSubtitle;
  LPWSTR pszTask;
  UINT   cchTask;
  LPWSTR pszDescriptionTop;
  UINT   cchDescriptionTop;
  LPWSTR pszDescriptionBottom;
  UINT   cchDescriptionBottom;
  int    iTitleImage;
  int    iExtendedImage;
  int    iFirstItem;
  UINT   cItems;
  LPWSTR pszSubsetTitle;
  UINT   cchSubsetTitle;
} LVGROUP, *PLVGROUP;

Membres

cbSize

Type : UINT

Taille de cette structure, en octets.

mask

Type : UINT

Masque qui spécifie les membres de la structure qui sont une entrée valide. Une ou plusieurs des valeurs suivantes :

pszHeader

Type : LPWSTR

Pointeur vers une chaîne terminée par null qui contient le texte d’en-tête lorsque les informations d’élément sont définies. Si les informations de groupe sont récupérées, ce membre spécifie l’adresse de la mémoire tampon qui reçoit le texte d’en-tête.

cchHeader

Type : int

Taille en TCHARs de la mémoire tampon pointée par le membre pszHeader . Si la structure ne reçoit pas d’informations sur un groupe, ce membre est ignoré.

pszFooter

Type : LPWSTR

Pointeur vers une chaîne terminée par null qui contient le texte du pied de page lorsque les informations d’élément sont définies. Si les informations de groupe sont récupérées, ce membre spécifie l’adresse de la mémoire tampon qui reçoit le texte du pied de page.

cchFooter

Type : int

Taille dans TCHARs de la mémoire tampon pointée par le membre pszFooter . Si la structure ne reçoit pas d’informations sur un groupe, ce membre est ignoré.

iGroupId

Type : int

ID du groupe.

stateMask

Type : UINT

Masque utilisé avec LVM_GETGROUPINFO et LVM_SETGROUPINFO pour spécifier les indicateurs de la valeur d’état qui sont récupérés ou définis.

state

Type : UINT

Indicateur qui peut avoir l’une des valeurs suivantes :

uAlign

Type : UINT

Indique l’alignement du texte d’en-tête ou de pied de page du groupe. Il peut avoir une ou plusieurs des valeurs suivantes. Utilisez l’un des indicateurs d’en-tête. Les indicateurs de pied de page sont facultatifs.

pszSubtitle

Type : LPWSTR

Pointeur vers une chaîne terminée par null qui contient le texte du sous-titre lorsque les informations d’élément sont définies. Si les informations de groupe sont récupérées, ce membre spécifie l’adresse de la mémoire tampon qui reçoit le texte du sous-titre. Cet élément est dessiné sous le texte d’en-tête.

cchSubtitle

Type : UINT

Taille, en TCHARs, de la mémoire tampon pointée vers le membre pszSubtitle . Si la structure ne reçoit pas d’informations sur un groupe, ce membre est ignoré.

pszTask

Type : LPWSTR

Pointeur vers une chaîne terminée par null qui contient le texte d’un lien de tâche lorsque les informations d’élément sont définies. Si les informations de groupe sont récupérées, ce membre spécifie l’adresse de la mémoire tampon qui reçoit le texte de la tâche. Cet élément est dessiné à droite, en face du texte d’en-tête. Lorsque l’utilisateur clique dessus, le lien de tâche génère une notification LVN_LINKCLICK .

cchTask

Type : UINT

Taille dans TCHARs de la mémoire tampon pointée par le membre pszTask . Si la structure ne reçoit pas d’informations sur un groupe, ce membre est ignoré.

pszDescriptionTop

Type : LPWSTR

Pointeur vers une chaîne terminée par null qui contient le texte de description supérieur lorsque les informations d’élément sont définies. Si les informations de groupe sont récupérées, ce membre spécifie l’adresse de la mémoire tampon qui reçoit le texte de description supérieur. Cet élément est dessiné en face de l’image de titre lorsqu’il existe une image de titre, aucune image étendue et uAlign==LVGA_HEADER_CENTER.

cchDescriptionTop

Type : UINT

Taille dans TCHARs de la mémoire tampon pointée par le membre pszDescriptionTop . Si la structure ne reçoit pas d’informations sur un groupe, ce membre est ignoré.

pszDescriptionBottom

Type : LPWSTR

Pointeur vers une chaîne terminée par null qui contient le texte de description inférieur lorsque des informations d’élément sont définies. Si les informations de groupe sont récupérées, ce membre spécifie l’adresse de la mémoire tampon qui reçoit le texte de description inférieur. Cet élément est dessiné sous le texte de description supérieur lorsqu’il existe une image de titre, aucune image étendue et uAlign==LVGA_HEADER_CENTER.

cchDescriptionBottom

Type : UINT

Taille dans TCHARs de la mémoire tampon pointée par le membre pszDescriptionBottom . Si la structure ne reçoit pas d’informations sur un groupe, ce membre est ignoré.

iTitleImage

Type : int

Index de l’image de titre dans la liste d’images de contrôle.

iExtendedImage

Type : int

Index de l’image étendue dans la liste d’images de contrôle.

iFirstItem

Type : int

Lecture seule.

cItems

Type : UINT

En lecture seule en mode de données non propriétaire.

pszSubsetTitle

Type : LPWSTR

NULL si le groupe n’est pas un sous-ensemble. Pointeur vers une chaîne terminée par null qui contient le texte de titre du sous-ensemble lorsque les informations d’élément sont définies. Si les informations de groupe sont récupérées, ce membre spécifie l’adresse de la mémoire tampon qui reçoit le texte du titre du sous-ensemble.

cchSubsetTitle

Type : UINT

Taille dans TCHARs de la mémoire tampon pointée par le membre pszSubsetTitle . Si la structure ne reçoit pas d’informations sur un groupe, ce membre est ignoré.

Remarques

Toutes les chaînes retournées dans cette structure doivent être traitées en lecture seule.

La création de sous-ensembles n’est actuellement pas prise en charge et pszSubsetTitle ne peut pas être défini par les applications.

Configuration requise