TreeView.StateImageList プロパティ

.NET Framework クラス ライブラリ リファレンス

TreeView.StateImageList プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

TreeView およびそのノードの状態を示すために使用するイメージ リストを取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property StateImageList As
 ImageList

Visual Basic (使用法)

Dim instance As TreeView
Dim value As ImageList

value = instance.StateImageList

instance.StateImageList = value

C#

public ImageList StateImageList { get; set;
 }

C++

public:
property ImageList^ StateImageList {
    ImageList^ get ();
    void set (ImageList^ value);
}

J#

/** @property */
public ImageList get_StateImageList ()

/** @property */
public void set_StateImageList (ImageList value)

JScript

public function get StateImageList
 () : ImageList

public function set StateImageList
 (value : ImageList)

プロパティ値
TreeView およびそのノードの状態を示すために使用する ImageList。

解説

TreeNode の状態を示すには、StateImageList プロパティと共に、各 TreeNode の StateImageKey プロパティまたは StateImageIndex プロパティを設定します。

TreeView に表示される状態イメージは常に 16 x 16 ピクセルであり、StateImageList の ImageSize プロパティを設定しても、イメージの表示方法に影響はありません。

TreeView の CheckBoxes プロパティが true に設定されており、かつ StateImageList プロパティが設定されている場合、TreeView に含まれる各 TreeNode には、チェックされていない状態であるかチェックされた状態であるかを示すために、StateImageList の最初のイメージと 2 番目のイメージがそれぞれ表示されます。デザイン時に状態イメージが設定されていないノードの状態イメージが表示されないようにするには、TreeView にノードを追加する前に、StateImageList プロパティを設定する必要があります。

使用例

StateImageList プロパティのコード例を次に示します。この例を実行するには、コードを Windows フォームに貼り付け、フォームのコンストラクタまたは Load のイベント処理メソッドから、InitializeCheckTreeView を呼び出します。

Visual Basic

Private checkTreeView As TreeView

Private Sub InitializeCheckTreeView() 
    checkTreeView = New TreeView()
    
    ' Show check boxes for the TreeView.
    checkTreeView.CheckBoxes = True
    
    ' Create the StateImageList and add two images.
    checkTreeView.StateImageList = New ImageList()
    checkTreeView.StateImageList.Images.Add(SystemIcons.Question)
    checkTreeView.StateImageList.Images.Add(SystemIcons.Exclamation)
    
    ' Add some nodes to the TreeView and the TreeView to the form.
    checkTreeView.Nodes.Add("Node1")
    checkTreeView.Nodes.Add("Node2")
    Me.Controls.Add(checkTreeView)

End Sub

C#

TreeView checkTreeView;
private void InitializeCheckTreeView()
{
    checkTreeView = new TreeView();
    
    // Show check boxes for the TreeView. This
    // will cause the StateImageList to be used.
    checkTreeView.CheckBoxes = true;

    // Create the StateImageList and add two images.
    checkTreeView.StateImageList = new ImageList();
    checkTreeView.StateImageList.Images.Add(SystemIcons.Question);
    checkTreeView.StateImageList.Images.Add(SystemIcons.Exclamation);
    
    // Add some nodes to the TreeView and the TreeView to the form.
    checkTreeView.Nodes.Add("Node1");
    checkTreeView.Nodes.Add("Node2");
    this.Controls.Add(checkTreeView);
}

C++

    TreeView^ checkTreeView;
private:
    void InitializeCheckTreeView()
    {
        checkTreeView = gcnew TreeView();

        // Show check boxes for the TreeView. This
        // will cause the StateImageList to be used.
        checkTreeView->CheckBoxes = true;

        // Create the StateImageList and add two images.
        checkTreeView->StateImageList = gcnew ImageList();
        checkTreeView->StateImageList->Images->Add(SystemIcons::Question);
        checkTreeView->StateImageList->Images->Add(SystemIcons::Exclamation);

        // Add some nodes to the TreeView and the TreeView to the form.
        checkTreeView->Nodes->Add("Node1");
        checkTreeView->Nodes->Add("Node2");
        this->Controls->Add(checkTreeView);
    }

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TreeView クラス
TreeView メンバ
System.Windows.Forms 名前空間