TreeNode.SelectedImageIndex Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

TreeNode.cs

Ağaç düğümü seçili durumdayken görüntülenen görüntünün görüntü listesi dizin değerini alır veya ayarlar.

C#

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.TreeViewImageIndexConverter))]
[System.Windows.Forms.RelatedImageList("TreeView.ImageList")]
public int SelectedImageIndex { get; set; }

Özellik Değeri

Int32

bir içindeki görüntü konumunu temsil eden sıfır tabanlı dizin ImageListdeğeri.

Öznitelikler

TypeConverterAttribute RelatedImageListAttribute

Özel durumlar

ArgumentOutOfRangeException

.NET 5 ve üzeri: value -2'den küçük.

Örnekler

Aşağıdaki kod örneği bir ImageListTreeView denetim oluşturup bir denetime atar ve denetimi nesnelerle TreeNode doldururTreeView. Ağaç düğümlerine, ağaç düğümü seçili veya seçilmemiş durumdayken görüntülenen öğesinden ImageList görüntüler atanır. Bu örnek, içeren bir FormTreeViewöğesini ve her biri nesne içeren nesneleri içeren CustomerOrder bir ArrayList nesneye sahip olmasını gerektirir. Ayrıca ve Order nesnelerinin Customer tanımlanmasını da gerektirir.

C#

public class Customer
{
   public ArrayList CustomerOrders;
   public string CustomerName;
   public Customer(string myName)
   {
      CustomerName = myName;
      CustomerOrders = new ArrayList(); 
   }
}
public class Order
{
   public string OrderID;
   public Order(string myOrderID )
   {
      this.OrderID = myOrderID;
   }
}

private void FillTreeView()
{
    // Load the images in an ImageList.
    ImageList myImageList = new ImageList();
    myImageList.Images.Add(Image.FromFile("Default.gif"));
    myImageList.Images.Add(Image.FromFile("SelectedDefault.gif"));
    myImageList.Images.Add(Image.FromFile("Root.gif"));
    myImageList.Images.Add(Image.FromFile("UnselectedCustomer.gif"));
    myImageList.Images.Add(Image.FromFile("SelectedCustomer.gif"));
    myImageList.Images.Add(Image.FromFile("UnselectedOrder.gif"));
    myImageList.Images.Add(Image.FromFile("SelectedOrder.gif"));
    
    // Assign the ImageList to the TreeView.
    myTreeView.ImageList = myImageList;
    
    // Set the TreeView control's default image and selected image indexes.
    myTreeView.ImageIndex = 0;
    myTreeView.SelectedImageIndex = 1;

    /* Set the index of image from the 
    ImageList for selected and unselected tree nodes.*/
    this.rootImageIndex = 2;
    this.selectedCustomerImageIndex = 3;
    this.unselectedCustomerImageIndex = 4;
    this.selectedOrderImageIndex = 5;
    this.unselectedOrderImageIndex = 6;
    
    // Create the root tree node.
    TreeNode rootNode = new TreeNode("CustomerList");
    rootNode.ImageIndex = rootImageIndex;
    rootNode.SelectedImageIndex = rootImageIndex;
      
    // Add a main root tree node.
    myTreeView.Nodes.Add(rootNode);

    // Add a root tree node for each Customer object in the ArrayList.
    foreach(Customer myCustomer in customerArray)
    {
        // Add a child tree node for each Order object.
        int countIndex=0;
        TreeNode[] myTreeNodeArray = new TreeNode[myCustomer.CustomerOrders.Count];
        foreach(Order myOrder in myCustomer.CustomerOrders)
        {
            // Add the Order tree node to the array.
            myTreeNodeArray[countIndex] = new TreeNode(myOrder.OrderID,
              unselectedOrderImageIndex, selectedOrderImageIndex);
            countIndex++;
        }
        // Add the Customer tree node.
        TreeNode customerNode = new TreeNode(myCustomer.CustomerName,
            unselectedCustomerImageIndex, selectedCustomerImageIndex, myTreeNodeArray);
        myTreeView.Nodes[0].Nodes.Add(customerNode);
    }
}

Açıklamalar

SelectedImageIndex değeri, özelliğine atanan içinde ImageList depolanan bir Image dizinin değeridirTreeView.ImageList.

SelectedImageKey ve SelectedImageIndex birbirini dışlar, yani biri ayarlanırsa, diğeri geçersiz bir değere ayarlanır ve yoksayılır. Özelliğini ayarlarsanız SelectedImageKey , SelectedImageIndex özelliği otomatik olarak -1 olarak ayarlanır. Alternatif olarak, özelliğini ayarlarsanız SelectedImageIndex , SelectedImageKey otomatik olarak boş bir dize ("") olarak ayarlanır.

.NET 5 ve sonraki sürümleri: İlişkili ImageList özellik değeri olarak değiştirilirsenullSelectedImageIndex, özellik varsayılan değeri olan -1 değerini döndürür. Ancak, atanan SelectedImageIndex değer dahili olarak tutulur ve özelliğe başka bir ImageList nesne atandığında ImageList kullanılır. Özelliğe atanan yeni ImageList özelliğinImageList, özellik değerine atanan SelectedImageIndex değerden küçük veya buna eşit bir ImageList.ImageCollection.Count özellik değeri varsa (koleksiyonun sıfır tabanlı bir dizin olmasını hesaba katmak için), SelectedImageIndex özellik değeri özellik değerinden Count bir küçüke ayarlanır. Örneğin, üç görüntüsü olan ImageList ve SelectedImageIndex özelliği 2 olarak ayarlanmış bir düğme denetimini düşünün. Düğmeye yalnızca iki resim içeren bir yeni ImageList atanırsa, SelectedImageIndex değer 1 olarak değişir.

Not

özelliğinin SelectedImageIndex varsayılan değeri, öğesinin atandığı denetimin TreeView özelliğiyle TreeNode aynıdırSelectedImageIndex.

Şunlara uygulanır

Ayrıca bkz.

• ImageIndex