TreeView.StateImageList 속성

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

Source:

TreeView.cs

노드 및 해당 노드의 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 Form에 붙여넣고 양식의 생성자 또는 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나타내려면 속성을 설정하고 각각TreeNode에 StateImageListStateImageKey 대한 또는 StateImageIndex 속성도 설정합니다.

기본적으로 16 x 16 픽셀에 표시되는 TreeView 상태 이미지입니다. 속성을 ImageSizeStateImageList 설정해도 이미지가 표시되는 방식에는 영향을 주지 않습니다. 그러나 app.config 파일에 다음 항목이 포함된 경우 시스템 DPI 설정에 따라 상태 이미지의 크기가 조정됩니다.

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

속성이 CheckBoxes 설정 true 되고 StateImageList 속성이 설정되면 각 속성에 TreeView 포함된 각 TreeNode 이미지는 선택되지 않은 상태 또는 선택된 상태를 나타내기 위해 첫 번째 및 두 번째 이미지를 StateImageList 표시합니다.TreeView 상태 이미지 집합이 없는 노드 TreeView 의 StateImageList 디자인 타임에 상태 이미지가 표시되지 않도록 노드를 추가하기 전에 속성을 설정해야 합니다.