ListView_GetGroupRect macro (commctrl.h)

  • Article

Obtient le rectangle d’un groupe spécifié. Utilisez cette macro ou envoyez explicitement le message LVM_GETGROUPRECT .

Syntaxe

void ListView_GetGroupRect(
  [in]       hwnd,
  [in]       iGroupId,
  [in]       type,
  [in, out]  prc
);

Paramètres

[in] hwnd

Type : HWND

Handle pour le contrôle d’affichage de liste.

[in] iGroupId

Type : int

Spécifie le groupe par iGroupId (voir structure LVGROUP ).

[in] type

Type : LONG

Spécifie le type de rectangle à récupérer. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
LVGGR_GROUP
 Coordonnées de l’ensemble du groupe développé.
LVGGR_HEADER
 Coordonnées de l’en-tête uniquement (groupe réduit).
LVGGR_LABEL
 Coordonnées de l’étiquette uniquement.
LVGGR_SUBSETLINK
 Coordonnées du lien de sous-ensemble uniquement (sous-ensemble de balisage). Un contrôle d’affichage de liste peut limiter le nombre d’éléments visibles affichés dans chaque groupe. Un lien est présenté à l’utilisateur pour lui permettre de développer le groupe. Cet indicateur retourne le rectangle englobant du lien de sous-ensemble si le groupe est un sous-ensemble (état de groupe de LVGS_SUBSETED, voir structure LVGROUP, état membre). Cet indicateur est fourni afin que les applications d’accessibilité puissent localiser le lien.

[in, out] prc

Type : RECT*

Pointeur vers une structure RECT pour recevoir des informations sur le groupe spécifié par iGroupId. Le récepteur de messages est chargé de définir les membres de la structure avec des informations pour le groupe spécifié par iGroupId. L’application appelante est responsable de l’allocation de mémoire pour la structure.

Valeur de retour

Aucune

Configuration requise

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête commctrl.h