TreeView.GetNodeAt Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает узел дерева, который находится в указанном расположении.
Перегрузки
| GetNodeAt(Point) |
Возвращает узел дерева, расположенный в указанной точке. |
| GetNodeAt(Int32, Int32) |
Возвращает узел дерева, расположенный в точке с указанными координатами. |
GetNodeAt(Point)
Возвращает узел дерева, расположенный в указанной точке.
public:
System::Windows::Forms::TreeNode ^ GetNodeAt(System::Drawing::Point pt);public System.Windows.Forms.TreeNode GetNodeAt (System.Drawing.Point pt);public System.Windows.Forms.TreeNode? GetNodeAt (System.Drawing.Point pt);member this.GetNodeAt : System.Drawing.Point -> System.Windows.Forms.TreeNodePublic Function GetNodeAt (pt As Point) As TreeNodeПараметры
Возвращаемое значение
узел TreeNode в указанной точке в координатах иерархического представления (у клиента) или значение null, если в данном расположении нет узла.
Комментарии
Координаты MouseEventArgs.XMouseDown и MouseEventArgs.Y события можно передать в качестве значений X и Y для нового Pointобъекта .
См. также раздел
Применяется к
GetNodeAt(Int32, Int32)
Возвращает узел дерева, расположенный в точке с указанными координатами.
public:
System::Windows::Forms::TreeNode ^ GetNodeAt(int x, int y);public System.Windows.Forms.TreeNode GetNodeAt (int x, int y);public System.Windows.Forms.TreeNode? GetNodeAt (int x, int y);member this.GetNodeAt : int * int -> System.Windows.Forms.TreeNodePublic Function GetNodeAt (x As Integer, y As Integer) As TreeNodeПараметры
Возвращаемое значение
узел TreeNode в указанном расположении в координатах иерархического представления (у клиента) или значение null, если в данном расположении нет узла.
Примеры
В следующем примере кода пользователь может изменять узлы дерева, не являющиеся ролями, с помощью ContextMenu. Когда пользователь щелкает правой кнопкой мыши, объект в TreeNode этой позиции определяется и сохраняется в переменной с именем mySelectedNode. Если выбран узел, не являющийся деревом, он переводится в редактируемое состояние, что позволяет пользователю изменять метку узла. После того как пользователь прекратит редактирование метки узла дерева, новый текст метки вычисляется и сохраняется. В этом примере несколько символов считаются недопустимыми в тексте метки. Если один из недопустимых символов находится в строке метки или строка пуста, пользователь получает уведомление об ошибке и метка возвращается к предыдущему тексту.
/* Get the tree node under the mouse pointer and
save it in the mySelectedNode variable. */
private:
void treeView1_MouseDown( Object^ /*sender*/, System::Windows::Forms::MouseEventArgs^ e )
{
mySelectedNode = treeView1->GetNodeAt( e->X, e->Y );
}
void menuItem1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
if ( mySelectedNode != nullptr && mySelectedNode->Parent != nullptr )
{
treeView1->SelectedNode = mySelectedNode;
treeView1->LabelEdit = true;
if ( !mySelectedNode->IsEditing )
{
mySelectedNode->BeginEdit();
}
}
else
{
MessageBox::Show( String::Concat( "No tree node selected or selected node is a root node.\n",
"Editing of root nodes is not allowed." ), "Invalid selection" );
}
}
void treeView1_AfterLabelEdit( Object^ /*sender*/,
System::Windows::Forms::NodeLabelEditEventArgs^ e )
{
if ( e->Label != nullptr )
{
if ( e->Label->Length > 0 )
{
array<Char>^ temp0 = {'@','.',',','!'};
if ( e->Label->IndexOfAny( temp0 ) == -1 )
{
// Stop editing without canceling the label change.
e->Node->EndEdit( false );
}
else
{
/* Cancel the label edit action, inform the user, and
place the node in edit mode again. */
e->CancelEdit = true;
MessageBox::Show( String::Concat( "Invalid tree node label.\n",
"The invalid characters are: '@','.', ',', '!'" ),
"Node Label Edit" );
e->Node->BeginEdit();
}
}
else
{
/* Cancel the label edit action, inform the user, and
place the node in edit mode again. */
e->CancelEdit = true;
MessageBox::Show( "Invalid tree node label.\nThe label cannot be blank",
"Node Label Edit" );
e->Node->BeginEdit();
}
}
}
/* Get the tree node under the mouse pointer and
save it in the mySelectedNode variable. */
private void treeView1_MouseDown(object sender,
System.Windows.Forms.MouseEventArgs e)
{
mySelectedNode = treeView1.GetNodeAt(e.X, e.Y);
}
private void menuItem1_Click(object sender, System.EventArgs e)
{
if (mySelectedNode != null && mySelectedNode.Parent != null)
{
treeView1.SelectedNode = mySelectedNode;
treeView1.LabelEdit = true;
if(!mySelectedNode.IsEditing)
{
mySelectedNode.BeginEdit();
}
}
else
{
MessageBox.Show("No tree node selected or selected node is a root node.\n" +
"Editing of root nodes is not allowed.", "Invalid selection");
}
}
private void treeView1_AfterLabelEdit(object sender,
System.Windows.Forms.NodeLabelEditEventArgs e)
{
if (e.Label != null)
{
if(e.Label.Length > 0)
{
if (e.Label.IndexOfAny(new char[]{'@', '.', ',', '!'}) == -1)
{
// Stop editing without canceling the label change.
e.Node.EndEdit(false);
}
else
{
/* Cancel the label edit action, inform the user, and
place the node in edit mode again. */
e.CancelEdit = true;
MessageBox.Show("Invalid tree node label.\n" +
"The invalid characters are: '@','.', ',', '!'",
"Node Label Edit");
e.Node.BeginEdit();
}
}
else
{
/* Cancel the label edit action, inform the user, and
place the node in edit mode again. */
e.CancelEdit = true;
MessageBox.Show("Invalid tree node label.\nThe label cannot be blank",
"Node Label Edit");
e.Node.BeginEdit();
}
}
}
' Get the tree node under the mouse pointer and
' save it in the mySelectedNode variable.
Private Sub treeView1_MouseDown(sender As Object, _
e As System.Windows.Forms.MouseEventArgs)
mySelectedNode = treeView1.GetNodeAt(e.X, e.Y)
End Sub
Private Sub menuItem1_Click(sender As Object, e As System.EventArgs)
If Not (mySelectedNode Is Nothing) And _
Not (mySelectedNode.Parent Is Nothing) Then
treeView1.SelectedNode = mySelectedNode
treeView1.LabelEdit = True
If Not mySelectedNode.IsEditing Then
mySelectedNode.BeginEdit()
End If
Else
MessageBox.Show("No tree node selected or selected node is a root node." & _
Microsoft.VisualBasic.ControlChars.Cr & _
"Editing of root nodes is not allowed.", "Invalid selection")
End If
End Sub
Private Sub treeView1_AfterLabelEdit(sender As Object, _
e As System.Windows.Forms.NodeLabelEditEventArgs)
If Not (e.Label Is Nothing) Then
If e.Label.Length > 0 Then
If e.Label.IndexOfAny(New Char() {"@"c, "."c, ","c, "!"c}) = -1 Then
' Stop editing without canceling the label change.
e.Node.EndEdit(False)
Else
' Cancel the label edit action, inform the user, and
' place the node in edit mode again.
e.CancelEdit = True
MessageBox.Show("Invalid tree node label." & _
Microsoft.VisualBasic.ControlChars.Cr & _
"The invalid characters are: '@','.', ',', '!'", _
"Node Label Edit")
e.Node.BeginEdit()
End If
Else
' Cancel the label edit action, inform the user, and
' place the node in edit mode again.
e.CancelEdit = True
MessageBox.Show("Invalid tree node label." & _
Microsoft.VisualBasic.ControlChars.Cr & _
"The label cannot be blank", "Node Label Edit")
e.Node.BeginEdit()
End If
End If
End Sub
Комментарии
Координаты и события можно передать в xMouseDown качестве параметров и y .MouseEventArgs.YMouseEventArgs.X
