Partager via

macro ListView_GetGroupRect (commctrl.h)

  • Article

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

Syntaxe

BOOL ListView_GetGroupRect(
  [in]      HWND hwnd,
  [in]      int  iGroupId,
  [in]      LONG type,
  [in, out] RECT *prc
);

Paramètres

[in] hwnd

Type : HWND

Handle du contrôle list-view.

[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 doit être l’une des 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 permettre à l’utilisateur 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, consultez la structure LVGROUP, l’é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 de 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 chargée d’allouer de la mémoire pour la structure.

Valeur de retour

Type : BOOL

Retourne TRUE en cas de réussite ou FALSE sinon.

Exigences

Exigence Valeur
client minimum pris en charge Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2008 [applications de bureau uniquement]
plateforme cible Windows
d’en-tête commctrl.h