macro ListView_GetItemIndexRect (commctrl.h)

Articolo
10/24/2024

Ottiene il rettangolo di delimitazione per tutto o parte di un elemento secondario nella visualizzazione corrente di un controllo visualizzazione elenco specificato. Utilizzare questa macro o inviare il messaggio di LVM_GETITEMINDEXRECT in modo esplicito.

Sintassi

BOOL ListView_GetItemIndexRect(
  [in]      HWND        hwnd,
  [in]      LVITEMINDEX *plvii,
  [in]      LONG        iSubItem,
  [in]      LONG        code,
  [in, out] LPRECT      prc
);

Parametri

[in] hwnd

Tipo: HWND

Handle per il controllo visualizzazione elenco.

[in] plvii

Tipo: LVITEMINDEX*

Puntatore a una struttura LVITEMINDEX per l'elemento padre dell'elemento secondario. Il chiamante è responsabile dell'allocazione di questa struttura e dell'impostazione dei relativi membri. plvii non deve essere NULL.

[in] iSubItem

Tipo: LONG

Indice dell'elemento secondario.

[in] code

Tipo: LONG

Parte dell'elemento secondario della visualizzazione elenco per cui recuperare il rettangolo di delimitazione. Questo parametro deve essere uno dei valori seguenti.

Valore	Significato
LVIR_BOUNDS	Restituisce il rettangolo di delimitazione dell'intero elemento secondario, inclusa l'icona e l'etichetta.
LVIR_ICON	Restituisce il rettangolo di delimitazione dell'icona o dell'icona piccola dell'elemento secondario.
LVIR_LABEL	Restituisce il rettangolo di delimitazione del testo dell'elemento secondario.

[in, out] prc

Tipo: LPRECT

Puntatore a una struttura RECT per ricevere le coordinate. Il chiamante è responsabile dell'allocazione di questa struttura. prc non deve essere NULL.

Valore restituito

Tipo: BOOL

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

Osservazioni

Se iSubItem è zero, questa macro restituisce le coordinate del rettangolo all'elemento a cui punta plvii. Il valore LVIR_SELECTBOUNDS per il parametro codice non è supportato.

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

Condividi tramite