TreeView.TopNode Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

TreeView.cs

Ağaç görünümü denetimindeki ilk tam görünür ağaç düğümünü alır veya ayarlar.

C#

[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.TreeNode? TopNode { get; set; }

Özellik Değeri

TreeNode

Ağaç TreeNode görünümü denetimindeki ilk tam görünür ağaç düğümünü temsil eden bir.

Öznitelikler

BrowsableAttribute

Örnekler

Aşağıdaki kod örneği ve TopNode üyelerinin nasıl kullanılacağını BeforeLabelEditAfterSelect gösterir. Bu örneği çalıştırmak için, aşağıdaki kodu adlı TreeView1denetimi içeren bir TreeView forma yapıştırın. Formun InitializeTreeView oluşturucusunda veya Load yönteminde yöntemini çağırın.

C#

private void InitializeTreeView()
{

    // Construct the TreeView object.
    this.TreeView1 = new System.Windows.Forms.TreeView();

    // Set dock, location, size name, and tab order
    // values for the TreeView object.
    TreeView1.Dock = System.Windows.Forms.DockStyle.Left;
    TreeView1.Location = new System.Drawing.Point(0, 0);
    TreeView1.Name = "TreeView1";
    TreeView1.Size = new System.Drawing.Size(152, 266);
    TreeView1.TabIndex = 1;
    
    // Associate the event-handling methods with the
    // BeforeLabeEdit and the AfterSelect events.
    TreeView1.BeforeLabelEdit += 
        new NodeLabelEditEventHandler(TreeView1_BeforeLabelEdit);
    TreeView1.AfterSelect += 
        new TreeViewEventHandler(TreeView1_AfterSelect);

    // Set the LabelEdit property to true to allow the 
    // user to edit the TreeNode text.
    this.TreeView1.LabelEdit = true;

    // Declare and create objects needed to populate 
    // the TreeView.
    string[] files = new string[]{"bigPresentation.ppt", 
        "myFinances.xls", "myResume.doc"};; 
    string filePath = "c:\\myFiles";
    System.Collections.ArrayList nodes = 
        new System.Collections.ArrayList();

    // Create a node for each file, setting the Text property to the 
    // file's name and the Tag property to file's fully-qualified name.
    foreach ( string file in files )
    {
        TreeNode node = new TreeNode(file);
        node.Tag = filePath+"\\"+file;
        nodes.Add(node);
    }

    TreeNode[] treeNodes = new TreeNode[nodes.Count];
    nodes.CopyTo(treeNodes);

    // Create a new node named topNode and add the ArrayList of 
    // nodes to topNode.
    TreeNode topNode = new TreeNode("myFiles",  treeNodes);
    topNode.Tag = filePath;

    // Add topNode to the TreeView.
    TreeView1.Nodes.Add(topNode);

    // Add the TreeView to the form.
    this.Controls.Add(TreeView1);
}

private void TreeView1_BeforeLabelEdit(object sender, 
    NodeLabelEditEventArgs e)
{

    // Determine whether the user has selected the top node. If so,
    // change the CancelEdit property to true to cancel the edit.  
    if (e.Node == TreeView1.TopNode)

    {
        e.CancelEdit = true;
        MessageBox.Show("You are not allowed to edit the top node");
    }
}

C#

// Handle the After_Select event.
private void TreeView1_AfterSelect(System.Object sender, 
    System.Windows.Forms.TreeViewEventArgs e)
{

    // Vary the response depending on which TreeViewAction
    // triggered the event. 
    switch((e.Action))
    {
        case TreeViewAction.ByKeyboard:
            MessageBox.Show("You like the keyboard!");
            break;
        case TreeViewAction.ByMouse:
            MessageBox.Show("You like the mouse!");
            break;
    }
}

Açıklamalar

başlangıçta, TopNode öğesinin en üstünde bulunan ilk kök ağaç düğümünü TreeViewdöndürür. Ancak, kullanıcı içeriği kaydırdıysa, üst kısımda başka bir ağaç düğümü olabilir.

Not

Özellik değeri olduğunda falsebu özelliğin ayarlanmasının Scrollable hiçbir etkisi olmaz.

Şunlara uygulanır

Ayrıca bkz.

• IsVisible