CListCtrl::GetItemIndexRect

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

現在のリストビューコントロールのサブアイテムのすべてまたは一部に外接する四角形を取得します。

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

パラメータ

パラメータ	説明
[入力] pItemIndex	サブアイテムの親アイテムの LVITEMINDEX 構造体へのポインタ。呼び出し元は、LVITEMINDEX 構造体のメンバを割り当てて設定する必要があります。このパラメータには、NULL は指定できません。
[入力] iColumn	コントロールの列の 0 から始まるインデックス。
[入力] rectType	外接する四角形を取得するリストビューサブアイテムの部分。次のいずれかの値を指定します。 LVIR_BOUNDS - アイコンとラベルを含むサブアイテム全体に外接する四角形を返します。 LVIR_ICON - サブアイテムのアイコンまたは小さなアイコンに外接する四角形を返します。 LVIR_LABEL - サブアイテムのテキストに外接する四角形を返します。
[出力] pRect	サブアイテムに外接する四角形に関する情報を受け取る RECT 構造体へのポインタ。呼び出し元は、RECT 構造体を割り当てる必要があります。このパラメータには、NULL は指定できません。

戻り値

このメソッドが成功した場合は true。それ以外の場合は false。

解説

このメソッドは、LVM_GETITEMINDEXRECT メッセージを送信します。このメッセージについては、Windows SDK を参照してください。詳細については、「ListView_GetItemIndexRect Macro」を参照してください。

必要条件

ヘッダー : afxcmn.h

このコントロールは、Windows Vista およびそれ以降のバージョンでサポートされています。

このメソッドに関するその他の要件については、「Windows Vista コモンコントロールの作成要件」を参照してください。

使用例

次のコード例では、現在のリストビューコントロールにアクセスするために使用される変数 m_listCtrl を定義しています。この変数は、次の例で使用されます。

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

GetGroupRect メソッドのコード例を次に示します。このコード例を入力する前に、"ClientID" および "Grade" というタイトルの 2 つの列をレポートビューに表示するリストビューコントロールを作成しました。次のコード例では、両方の列の 2 つ目のサブアイテムの周囲に 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) );