CListCtrl::GetItemIndexRect

發行項
02/28/2013

擷取子項目的全部或部分的週框 (Bounding Rectangle) 目前的清單檢視控制項的。

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

參數

參數	描述
[in] pItemIndex	為 LVITEMINDEX 結構之指標子項目的父項目。呼叫端會負責配置和設定 LVITEMINDEX 結構的成員。這個參數不可以是 NULL。
[in] iColumn	一個資料行的以零起始的索引的控制項。
[in] rectType	週框 (Bounding Rectangle) 擷取清單檢視子項目的部分。指定下列其中一個值： LVIR_BOUNDS -傳回整個項目的週框，包括圖示和標籤 (Label)。 LVIR_ICON -傳回圖示或子項目的小圖示的週框。 LVIR_LABEL -傳回子項目文字的週框 (Bounding Rectangle)。
[out] pRect	要取得有關子項目的週框 (Bounding Rectangle) 的相關資訊的的長度結構的指標。呼叫端會負責配置的長度結構。這個參數不可以是 NULL。

傳回值

true ，如果此方法成功，否則， false。

備註

這個方法會將 LVM_GETITEMINDEXRECT 資訊，在 Windows SDK說明。如需詳細資訊，請參閱 ListView_GetItemIndexRect 巨集。

需求

標題: afxcmn.h

這個控制項在 Windows Vista (含) 以後版本支援。

這個方法的其他需要。組建的 Windows Vista 通用控制項的需求說明。

範例

下列程式碼範例會定義名為的變數， m_listCtrl，用於存取目前清單檢視控制項。這個變數用於下一個範例。

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

下列程式碼範例將示範 GetGroupRect 方法。在輸入這個程式碼範例之前我們建立顯示兩個資料行標題為「ClientID」和「訂單」將報告檢視中的清單檢視控制項。下列程式碼範例會在兩個資料行的第二個項目周圍繪製 3D 矩形。

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