macro ListView_GetGroupRect (commctrl.h)

  • Articolo

Ottiene il rettangolo per un gruppo specificato. Utilizzare questa macro o inviare il messaggio di LVM_GETGROUPRECT in modo esplicito.

Sintassi

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

Parametri

[in] hwnd

Tipo: HWND

Handle per il controllo visualizzazione elenco.

[in] iGroupId

Tipo: int

Specifica il gruppo iGroupId (vedere struttura LVGROUP).

[in] type

Tipo: LONG

Specifica il tipo di rettangolo da recuperare. Questo parametro deve essere uno dei valori seguenti.

Valore Significato
LVGGR_GROUP
 Coordinate dell'intero gruppo espanso.
LVGGR_HEADER
 Coordinate solo dell'intestazione (gruppo compresso).
LVGGR_LABEL
 Solo coordinate dell'etichetta.
LVGGR_SUBSETLINK
 Coordinate solo del collegamento del subset (subset di markup). Un controllo visualizzazione elenco può limitare il numero di elementi visibili visualizzati in ogni gruppo. Viene presentato un collegamento all'utente per consentire all'utente di espandere il gruppo. Questo flag restituirà il rettangolo di delimitazione del collegamento del subset se il gruppo è un subset (stato del gruppo di LVGS_SUBSETED, vedere struttura LVGROUP, stato membro ). Questo flag viene fornito in modo che le applicazioni di accessibilità possano individuare il collegamento.

[in, out] prc

Tipo: * RECT

Puntatore a una struttura per ricevere informazioni sul gruppo specificato da iGroupId. Il ricevitore del messaggio è responsabile dell'impostazione dei membri della struttura con informazioni per il gruppo specificato da iGroupId. L'applicazione chiamante è responsabile dell'allocazione della memoria per la struttura.

Valore restituito

Tipo: BOOL

Restituisce TRUE in caso di esito positivo oppure FALSE in caso contrario.

Fabbisogno

Requisito Valore
client minimo supportato Windows Vista [solo app desktop]
server minimo supportato Windows Server 2008 [solo app desktop]
piattaforma di destinazione Finestre
intestazione commctrl.h