TreeView.StateImageList Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Mendapatkan atau mengatur daftar gambar yang digunakan untuk menunjukkan status TreeView dan simpulnya.

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

Nilai Properti

ImageList

yang ImageList digunakan untuk menunjukkan status TreeView dan simpulnya.

Contoh

Contoh kode berikut menunjukkan StateImageList properti . Untuk menjalankan contoh ini, tempelkan kode ke dalam Formulir Windows dan panggil InitializeCheckTreeView dari konstruktor formulir atau Load penanganan aktivitas.

    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

Keterangan

Untuk menunjukkan status TreeNode, atur StateImageList properti dan atur StateImageKey juga properti atau StateImageIndex untuk setiap TreeNode.

Gambar status yang ditampilkan dalam TreeView adalah 16 x 16 piksel secara default. ImageSize Mengatur properti tidak StateImageList akan berpengaruh pada bagaimana gambar ditampilkan. Namun, gambar status diubah ukurannya sesuai dengan pengaturan DPI sistem ketika file app.config berisi entri berikut:

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

CheckBoxes Saat properti dari TreeView diatur ke true dan StateImageList properti diatur, masing-masing TreeNode yang terkandung dalam TreeView menampilkan gambar pertama dan kedua dari StateImageList untuk menunjukkan status yang tidak dicentang atau dicentang. Anda harus mengatur StateImageList properti sebelum menambahkan simpul ke TreeView untuk mencegah gambar status ditampilkan pada waktu desain untuk simpul yang tidak memiliki set gambar status.