CHeaderCtrl::GetItemDropDownRect

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

更新 : 2007 年 11 月

現在のヘッダーコントロールにあるヘッダー項目のドロップダウンボタンに外接する四角形を取得します。

BOOL GetItemDropDownRect(
          int iItem, 
          LPRECT lpRect
) const;

パラメータ

パラメータ	説明
[入力] iItem	スタイルが HDF_SPLITBUTTON のヘッダー項目の 0 から始まるインデックス。詳細については、HDITEM 構造体の fmt メンバを参照してください。
[出力] lpRect	外接する四角形の情報を受け取る RECT 構造体へのポインタ。

戻り値

この関数が成功した場合は true。それ以外の場合は false。

解説

このメソッドは、HDM_GETITEMDROPDOWNRECT メッセージを送信します。このメッセージについては、Windows SDK を参照してください。

必要条件

ヘッダー : afxcmn.h

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

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

使用例

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

   CHeaderCtrl m_headerCtrl;
    CSplitButton m_splitButton;

GetItemDropDownRect メソッドのコード例を次に示します。コードの前半部分では、5 つの列があるヘッダーコントロールを作成しました。次のコード例では、ヘッダードロップダウンボタンのために予約されている最初の列の場所の周囲に 3D の四角形を描画します。

void CNVC_MFC_CHeaderCtrl_s4Dlg::OnXGetitemdropdownrect()
{
    if (controlCreated == FALSE) {
        MessageBox(_T("Header control has not been created yet."));
        return;
    }

// Get the dropdown rect for the first column.
    CRect rect;
    BOOL bRetVal = m_headerCtrl.GetItemDropDownRect(0, &rect);
    if (bRetVal == TRUE) {
    // Draw around the dropdown rect a rectangle that has red 
    // left and top sides, and blue right and bottom sides.
        CDC* pDC = m_headerCtrl.GetDC();
        pDC->Draw3dRect(rect, RGB(255, 0, 0), RGB(0, 0, 255));
    }
}