CListCtrl::GetItemIndexRect

Articolo
06/10/2015

Recupera il rettangolo di delimitazione di tutto o parte di un elemento secondario nel controllo elenco corrente.

BOOL GetItemIndexRect(
     PLVITEMINDEX pItemIndex, 
     int iColumn, 
     int rectType, 
     LPRECT pRect
) const;

Parametri

Parametro	Descrizione
[in] pItemIndex	Puntatore a una struttura LVITEMINDEX per l'elemento padre dell'elemento secondario. Il chiamante è responsabile di allocare e di impostare i membri della struttura LVITEMINDEX. Questo parametro non può essere NULL.
[in] iColumn	Indice in base zero di una colonna del controllo.
[in] rectType	La parte dell'elemento secondario di visualizzazione elenco per il quale il rettangolo di delimitazione reclamata. Specificare uno dei seguenti valori: LVIR_BOUNDS - restituisce il rettangolo di delimitazione dell'intero elemento secondario, inclusi l'icona e l'etichetta. LVIR_ICON - restituisce il rettangolo di delimitazione dell'icona o di piccola icona dell'elemento secondario. LVIR_LABEL - restituisce il rettangolo di delimitazione di testo dell'elemento secondario.
[out] pRect	Puntatore a una struttura RECT che riceve informazioni sul rettangolo di delimitazione dell'elemento secondario. Il chiamante è responsabile di allocare la struttura RECT. Questo parametro non può essere NULL.

Valore restituito

true se questo metodo ha esito positivo; in caso contrario, false.

Note

Questo metodo invia il messaggio LVM_GETITEMINDEXRECT, come descritto in Windows SDK. Per ulteriori informazioni, vedere macro di ListView_GetItemIndexRect.

Requisiti

intestazione: afxcmn.h

Questo controllo è supportato in Windows Vista e versioni successive.

i requisiti aggiuntivi per questo metodo sono descritti in Requisiti di compilazione per i controlli comuni di Windows Vista.

Esempio

Nell'esempio di codice definisce una variabile, m_listCtrl, utilizzata per accedere al controllo elenco corrente. Questa variabile viene utilizzata nell'esempio seguente.

public:
    // Variable used to access the list control.
    CListCtrl m_listCtrl;

Nell'esempio di codice riportato di seguito viene illustrato l'utilizzo del metodo GetGroupRect. Prima di fornire questo esempio di codice seguente viene creato un controllo elenco che visualizza due colonne denominato "ClientID" e "conversione" in una visualizzazione report. Nell'esempio di codice seguente consente di tracciare un rettangolo 3D nel secondo elemento secondario in entrambe le colonne.

    // GetItemIndexRect 
    // Get the rectangle that bounds the second item in the first group.
    LVITEMINDEX lvItemIndex;
    lvItemIndex.iGroup = 0;
    lvItemIndex.iItem = 1;
    CRect rect;
    BOOL bRet = m_listCtrl.GetItemIndexRect(
        &lvItemIndex, 0, LVIR_BOUNDS, &rect);

    // Draw a red rectangle around the item.
    m_listCtrl.GetDC()->Draw3dRect( &rect, RGB(255, 0, 0), RGB(255, 0, 0) );