Control.MousePosition Propriedade

public:
 static property System::Drawing::Point MousePosition { System::Drawing::Point get(); };

public static System.Drawing.Point MousePosition { get; }

static member MousePosition : System.Drawing.Point

Public Shared ReadOnly Property MousePosition As Point

Valor de Propriedade

A Point que contém as coordenadas do cursor do rato em relação ao canto superior esquerdo do ecrã.

Exemplos

O seguinte exemplo de código coloca um TreeNode rótulo num estado editável quando o utilizador pressiona ALT+E enquanto o cursor do rato está sobre o nó da árvore. Depois de o utilizador terminar de editar a etiqueta, as etiquetas não podem ser editadas novamente até que a combinação de teclas ALT+E seja pressionada novamente. Este exemplo exige que tenhas um TreeView em um Form. A vista em árvore também deve ter pelo menos uma TreeNode na sua Nodes coleção.

private:
   void treeView1_KeyDown( Object^ /*sender*/, KeyEventArgs^ e )
   {
      /* If the 'Alt' and 'E' keys are pressed,
         * allow the user to edit the TreeNode label. */
      if ( e->Alt && e->KeyCode == Keys::E )
      {
         treeView1->LabelEdit = true;
         
         // If there is a TreeNode under the mouse cursor, begin editing.
         TreeNode^ editNode = treeView1->GetNodeAt( treeView1->PointToClient( Control::MousePosition ) );
         if ( editNode != nullptr )
         {
            editNode->BeginEdit();
         }
      }
   }

   void treeView1_AfterLabelEdit( Object^ /*sender*/, NodeLabelEditEventArgs^ /*e*/ )
   {
      // Disable the ability to edit the TreeNode labels.
      treeView1->LabelEdit = false;
   }

private void treeView1_KeyDown(object sender, KeyEventArgs e)
{
   /* If the 'Alt' and 'E' keys are pressed,
      * allow the user to edit the TreeNode label. */
   if(e.Alt && e.KeyCode == Keys.E)
         
   {
      treeView1.LabelEdit = true;
      // If there is a TreeNode under the mouse cursor, begin editing. 
      TreeNode editNode = treeView1.GetNodeAt(
         treeView1.PointToClient(System.Windows.Forms.Control.MousePosition));
      if(editNode != null)
      { 
         editNode.BeginEdit();
      }
   }
}

private void treeView1_AfterLabelEdit(object sender, NodeLabelEditEventArgs e)
{
   // Disable the ability to edit the TreeNode labels.
   treeView1.LabelEdit = false;
}

Private Sub treeView1_KeyDown(sender As Object, _
  e As KeyEventArgs) Handles treeView1.KeyDown
   ' If the 'Alt' and 'E' keys are pressed,
   ' allow the user to edit the TreeNode label. 
   If e.Alt And e.KeyCode = Keys.E Then
      treeView1.LabelEdit = True
      ' If there is a TreeNode under the mouse cursor, begin editing. 
      Dim editNode As TreeNode = treeView1.GetNodeAt( _
        treeView1.PointToClient(System.Windows.Forms.Control.MousePosition))
      If (editNode IsNot Nothing) Then
         editNode.BeginEdit()
      End If
   End If
End Sub

Private Sub treeView1_AfterLabelEdit(sender As Object, _
  e As NodeLabelEditEventArgs) Handles treeView1.AfterLabelEdit
   ' Disable the ability to edit the TreeNode labels.
   treeView1.LabelEdit = False
End Sub

Observações

A MousePosition propriedade devolve a Point que representa a posição do cursor do rato no momento em que a propriedade foi referenciada. As coordenadas indicam a posição no ecrã, não relativa ao controlo, e são devolvidas independentemente de o cursor estar posicionado sobre o controlo. As coordenadas do canto superior esquerdo do ecrã são 0,0.

A MousePosition propriedade é idêntica à Cursor.Position propriedade.

Ver também

• Point
• MouseEventArgs