CListCtrl::GetItemIndexRect

Articolo
03/05/2013

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) );