CTreeCtrl::SetExtendedStyle

更新 : 2007 年 11 月

現在のツリー ビュー コントロールの拡張スタイルを設定します。

DWORD SetExtendedStyle(
            DWORD dwExMask, 
      DWORD dwExStyles
);

パラメータ

パラメータ

説明

[入力] dwExMask

このメソッドで設定する現在のツリー ビュー コントロールのスタイルを指定するビットマスク。このパラメータがゼロの場合、このパラメータは無視され、dwExStyles パラメータの値がツリー ビュー コンロトールに割り当てられます。

ゼロを指定するか、「Tree-View Control Extended Styles」で説明されているスタイルのビットごとの組み合わせ (OR) を指定します。

[入力] dwExStyles

設定または解除の対象になる現在のツリー ビュー コントロールのスタイルを指定するビットマスク。

スタイルの組み合わせを設定する場合は、「Tree-View Control Extended Styles」で説明されているスタイルのビットごとの組み合わせ (OR) を指定します。スタイルのセットを解除する場合は、ゼロを指定します。

戻り値

以前の拡張コントロール スタイルを示す値。

解説

このメソッドは、dwExMask パラメータで指定されているスタイルを解除してから、dwExStyles パラメータで指定されているスタイルを設定します。dwExMask に含まれている各ビットに対応する拡張スタイルだけが変更されます。

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

必要条件

ヘッダー : afxcmn.h

このメソッドは Windows XP 以降でサポートされています。

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

使用例

次のコード例では、現在のツリー ビュー コントロールにアクセスするために使用される変数 m_treeCtrl を定義しています。コード例では、符号なし整数といくつかの HTREEITEM 変数も定義しています。これらの変数は、次の例で使用されます。

public:
    // Variable to access tree control.
    CTreeCtrl m_treeCtrl;
    // Variable to access splitbutton control.
    CSplitButton m_splitbutton;
    // Accessibility identifier
    UINT accIdUS;
    // HTREEITEMs
    HTREEITEM hCountry;
    HTREEITEM hPA;
    HTREEITEM hWA;

次のコード例では、TVS_EX_AUTOHSCROLL 拡張スタイルを現在のツリー ビュー コントロールに追加しています。ここには示されていないコード例の前半では、ルート ノードである米国ノード、ペンシルバニア州とワシントン州を表すサブノード、およびこれらの州の都市を表すツリー アイテムから構成されるツリー ビューを作成しました。ツリー ビュー コントロールが自動的にスクロールしてフォーカスのあるツリー アイテムが表示されるように、ツリー ビュー コントロールの幅を意図的に狭くしています。

    m_treeCtrl.SetExtendedStyle(TVS_EX_AUTOHSCROLL, TVS_EX_AUTOHSCROLL);

参照

参照

CTreeCtrl クラス

階層図

TVM_SETEXTENDEDSTYLE

CTreeCtrl::GetExtendedStyle

Tree-View Control Extended Styles

その他の技術情報

CTreeCtrl のメンバ