События серверного веб-элемента управления TreeView

Visual Studio 2010

Обновлен: Ноябрь 2007

Серверный веб-элемент управления TreeView предоставляет несколько событий, которые можно запрограммировать. Это означает, что при возникновении событий можно осуществлять запуск пользовательских процедур.

События элемента управления TreeView возникают только при взаимодействии пользователя с элементом управления, например, при выборе, развертывании или сворачивании узла. События не возникают при вызове методов выбора, развертывания или сворачивания программными средствами. Например, при вызове метода Expand не возникнет ни одного события.

В следующей таблице описаны события, которые поддерживаются элементом управления TreeView.

Событие

Описание

TreeNodeCheckChanged

Возникает при изменении состояния флажка элемента управления TreeView между отправками на сервер. Возникает один раз для каждого изменяющегося объекта TreeNode.

SelectedNodeChanged

Возникает при выборе узла в элементе управления TreeView.

TreeNodeExpanded

Возникает при разворачивании узла в элементе управления TreeView.

TreeNodeCollapsed

Возникает при сворачивании узла в элементе управления TreeView.

TreeNodePopulate

Возникает, когда в элементе управления TreeView разворачивается узел, у которого свойство PopulateOnDemand имеет значение true.

TreeNodeDataBound

Возникает, когда элемент данных привязан к узлу в элементе управления TreeView.

Событие SelectedNodeChanged

В следующем примере кода демонстрируется обработка события SelectedNodeChanged и доступ к свойству SelectedNode, которое вызвало событие. Событию SelectedNode назначается свойство ToolTip со значением MyLabel.

protected void TreeView1_SelectedNodeChanged(object sender, EventArgs e)
{
    MyLabel.Text = TreeView1.SelectedNode.ToolTip;
}

События TreeNodeExpanded и TreeNodeCollapsed

В следующем примере демонстрируется обработка событий TreeNodeCollapsed и TreeNodeExpanded и последующий доступ к объекту TreeNode, который был свернут или развернут.

protected void TreeView1_TreeNodeCollapsed(object sender, TreeNodeEventArgs e)
{
    MyLabel.Text = "You collapsed the " + e.Node.Value + " node.";
}
protected void TreeView1_TreeNodeExpanded(object sender, TreeNodeEventArgs e)
{
    MyLabel.Text = "You expanded the " + e.Node.Value + " node.";
}

Событие TreeNodePopulate

В следующем примере демонстрируется обработка события TreeNodePopulate и программное добавление нового объекта TreeNode к коллекции ChildNodes узла, вызвавшего событие.

protected void TreeView1_TreeNodePopulate(object sender, TreeNodeEventArgs e)
{
    e.Node.ChildNodes.Add(new TreeNode("New Node Populated on Demand"));
}
Показ: