TreeView.StateImageList 속성

정의

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; }
public System.Windows.Forms.ImageList? StateImageList { get; set; }
member this.StateImageList : System.Windows.Forms.ImageList with get, set
Public Property StateImageList As 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상태를 나타내려면 속성을 설정하고 StateImageListTreeNodeStateImageKey 대한 또는 StateImageIndex 속성도 설정합니다.

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

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

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

적용 대상