TreeView.SelectedImageIndex Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

TreeView.cs

Bir ağaç düğümü seçildiğinde 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.NoneExcludedImageIndexConverter))]
[System.Windows.Forms.RelatedImageList("ImageList")]
public int SelectedImageIndex { get; set; }

Özellik Değeri

Int32

içindeki konumunu Image temsil eden sıfır tabanlı dizin ImageListdeğeri.

Öznitelikler

TypeConverterAttribute RelatedImageListAttribute

Özel durumlar

ArgumentOutOfRangeException

value -1'den küçüktür.

Örnekler

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

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 dizinindirImageList.

Not

Özelliği çalışma zamanında ayarlarken SelectedImageIndex , denetimin TreeView görünümünü güncelleştirmek için tanıtıcı yeniden oluşturulur (bkz Control.RecreateHandle. ). Bu, seçilen TreeNodedışında tüm ağaç düğümlerinin daraltılmasına neden olur.

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 özelliği SelectedImageIndex otomatik olarak -1 olarak ayarlanır. Alternatif olarak, özelliğini ayarlarsanız SelectedImageIndex , SelectedImageKey otomatik olarak boş bir dizeye ("") ayarlanır.

Şunlara uygulanır

Ayrıca bkz.

• ImageList
• ImageIndex