TreeView.GetNodeAt Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Recupera o nó de árvore que está no local especificado.
Sobrecargas
| GetNodeAt(Point) |
Recupera o nó de árvore que está no ponto especificado. |
| GetNodeAt(Int32, Int32) |
Recupera o nó de árvore no ponto com as coordenadas especificadas. |
GetNodeAt(Point)
Recupera o nó de árvore que está no ponto especificado.
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 TreeNodeParâmetros
Retornos
O TreeNode no ponto especificado, em coordenadas do modo de exibição de árvore (de cliente) ou então null se não houver nenhum nó nesse local.
Comentários
Você pode passar as MouseEventArgs.X coordenadas e MouseEventArgs.Y do MouseDown evento como os X valores e Y de um novo Point.
Confira também
Aplica-se a
GetNodeAt(Int32, Int32)
Recupera o nó de árvore no ponto com as coordenadas especificadas.
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 TreeNodeParâmetros
Retornos
O TreeNode no local especificado, em coordenadas do modo de exibição de árvore (de cliente) ou então null se não houver nenhum nó nesse local.
Exemplos
O exemplo de código a seguir permite que o usuário edite nós de árvore não padrão usando um ContextMenu. Quando o usuário clica com o botão direito do mouse, o TreeNode nessa posição é determinado e armazenado em uma variável chamada mySelectedNode. Se um nó de árvore não de caracteres tiver sido selecionado, ele será colocado em um estado editável, o que permite que o usuário edite o rótulo do nó. Depois que o usuário para de editar o rótulo do nó de árvore, o novo texto do rótulo é avaliado e salvo. Para este exemplo, vários caracteres são considerados inválidos no texto do rótulo. Se um dos caracteres inválidos estiver na cadeia de caracteres de rótulo ou a cadeia de caracteres estiver vazia, o usuário será notificado sobre o erro e o rótulo será retornado ao texto anterior.
/* 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
Comentários
Você pode passar as MouseEventArgs.X coordenadas e MouseEventArgs.Y do MouseDown evento como os x parâmetros e y .
