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 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상태를 나타내려면 속성을 설정하고 StateImageList 각 TreeNode에 StateImageKey 대한 또는 StateImageIndex 속성도 설정합니다.

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

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

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