CHeaderCtrl::SetFocusedItem

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

更新 : 2007 年 11 月

現在のヘッダーコントロールの指定したヘッダー項目にフォーカスを設定します。

BOOL SetFocusedItem(
          int iItem
);

パラメータ

パラメータ	説明
[入力] iItem	ヘッダー項目の 0 から始まるインデックス。

戻り値

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

解説

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

必要条件

ヘッダー : afxcmn.h

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

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

使用例

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

 CHeaderCtrl m_headerCtrl;
    CSplitButton m_splitButton;

SetFocusedItem メソッドおよび GetFocusedItem メソッドのコード例を次に示します。コードの前半部分では、5 つの列があるヘッダーコントロールを作成しました。ただし、列の区切り記号をドラッグして、列を非表示にできます。次の例では、最後の列ヘッダーをフォーカスアイテムとして設定してから、確認しています。

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

    // Check that we get the value we set.
    int item = m_headerCtrl.GetItemCount() - 1;
    m_headerCtrl.SetFocusedItem(item);
    int itemGet = m_headerCtrl.GetFocusedItem();
    CString str = _T("Set: focused item = %d\nGet: focused item = %d");
    str.Format(str, item, itemGet);
    MessageBox(str, _T("Set/GetFocused Item"));
}