TreeView.StateImageList 属性

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

获取或设置图像列表，该列表用于指示 TreeView 及其节点的状态。

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

public System.Windows.Forms.ImageList StateImageList { get; set; }

member this.StateImageList : System.Windows.Forms.ImageList with get, set

Public Property StateImageList As ImageList

属性值

ImageList

用于指示 ImageList 及其节点的状态的 TreeView。

示例

下面的代码示例演示 了 StateImageList 属性。 若要运行此示例，请将代码粘贴到 Windows 窗体中，然后从窗体的构造函数或Load事件处理程序调用 InitializeCheckTreeView 。

    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);
    }

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);
}

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

注解

若要指示 的状态 TreeNode，请设置 StateImageList 属性，并为每个 设置 StateImageKey 或 StateImageIndex 属性 TreeNode。

中显示 TreeView 的状态图像默认为 16 x 16 像素。 ImageSize设置 的 StateImageList 属性不会影响图像的显示方式。 但是，当app.config文件包含以下条目时，将根据系统 DPI 设置调整状态图像的大小：

<appSettings>
  <add key="EnableWindowsFormsHighDpiAutoResizing" value="true" />
</appSettings>

CheckBoxes当 的 TreeView 属性设置为 true 且 StateImageList 属性设置为 时，中包含的TreeView每个TreeNode图像分别显示 中的StateImageList第一个和第二个图像，以指示未选中或已选中状态。 在将节点TreeView添加到 之前，应设置 StateImageList 属性，以防止在设计时为未设置状态映像的节点显示状态图像。