Control.Cursor Control.Cursor Control.Cursor Control.Cursor Property

Definición

Obtiene o establece el cursor que se muestra cuando el puntero del mouse se sitúa sobre el control.Gets or sets the cursor that is displayed when the mouse pointer is over the control.

public:
 virtual property System::Windows::Forms::Cursor ^ Cursor { System::Windows::Forms::Cursor ^ get(); void set(System::Windows::Forms::Cursor ^ value); };
public virtual System.Windows.Forms.Cursor Cursor { get; set; }
member this.Cursor : System.Windows.Forms.Cursor with get, set
Public Overridable Property Cursor As Cursor

Valor de propiedad

Un Cursor que representa el cursor que se va a mostrar cuando el puntero del mouse se sitúe sobre el control.A Cursor that represents the cursor to display when the mouse pointer is over the control.

Ejemplos

El siguiente código de ejemplo se llena un ComboBox con unidades lógicas disponibles del usuario.The following code example fills a ComboBox with the user's available logical drives. El ejemplo también establece el cuadro combinado Cursor propiedad por lo que el Cursors.Hand cursor se muestra cuando el puntero del mouse está sobre el botón de lista desplegable.The example also sets the combo box's Cursor property so the Cursors.Hand cursor is displayed when the mouse pointer is over the drop-down button. Este código requiere que haya un Form con un ComboBox en él.This code requires that you have a Form with a ComboBox on it.

private:
   void Form1_Load( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      // Display the hand cursor when the mouse pointer
      // is over the combo box drop-down button.
      comboBox1->Cursor = Cursors::Hand;
      
      // Fill the combo box with all the logical
      // drives available to the user.
      try
      {
         IEnumerator^ myEnum = Environment::GetLogicalDrives()->GetEnumerator();
         while ( myEnum->MoveNext() )
         {
            String^ logicalDrive = safe_cast<String^>(myEnum->Current);
            comboBox1->Items->Add( logicalDrive );
         }
      }
      catch ( Exception^ ex ) 
      {
         MessageBox::Show( ex->Message );
      }
   }
private void Form1_Load(object sender, EventArgs e)
{
   // Display the hand cursor when the mouse pointer
   // is over the combo box drop-down button. 
   comboBox1.Cursor = Cursors.Hand;

   // Fill the combo box with all the logical 
   // drives available to the user.
   try
   {
      foreach(string logicalDrive in Environment.GetLogicalDrives() )
      {
         comboBox1.Items.Add(logicalDrive);
      }
   }
   catch(Exception ex)
   {
      MessageBox.Show(ex.Message);
   }
}
Private Sub Form1_Load(sender As Object, _
  e As EventArgs) Handles MyBase.Load
   ' Display the hand cursor when the mouse pointer
   ' is over the combo box drop-down button. 
   comboBox1.Cursor = Cursors.Hand
   
   ' Fill the combo box with all the logical 
   ' drives available to the user. 
   Try
      Dim logicalDrive As String
      For Each logicalDrive In  Environment.GetLogicalDrives()
         comboBox1.Items.Add(logicalDrive)
      Next logicalDrive
   Catch ex As Exception
      MessageBox.Show(ex.Message)
   End Try
End Sub

Comentarios

Asignar un Cursor a la Cursor propiedad del control para cambiar el cursor que se muestra cuando el puntero del mouse está encima del control.Assign a Cursor to the Cursor property of the control to change the cursor displayed when the mouse pointer is over the control. Para cambiar temporalmente el cursor del mouse para todos los controles en el conjunto de aplicaciones el Cursor.Current propiedad.To temporarily change the mouse cursor for all controls on your application set the Cursor.Current property. Normalmente, establecería el Cursor.Current propiedad a un cursor de espera al rellenar un ComboBox o guardar o cargar un archivo.Typically you would set the Cursor.Current property to a wait cursor when populating a ComboBox or saving or loading a file.

El Cursor es una propiedad de ambiente.The Cursor property is an ambient property. Una propiedad de ambiente es una propiedad de control que, si no establece, se recupera desde el control primario.An ambient property is a control property that, if not set, is retrieved from the parent control. Por ejemplo, un Button tendrá el mismo BackColor como su elemento primario Form de forma predeterminada.For example, a Button will have the same BackColor as its parent Form by default. Para obtener más información acerca de las propiedades de ambiente, vea la AmbientProperties clase o el Control información general de clases.For more information about ambient properties, see the AmbientProperties class or the Control class overview.

Notas a los desarrolladores de herederos

Cuando se reemplaza el Cursor propiedad en una clase derivada, utilice la clase base Cursor propiedad para extender la implementación base.When overriding the Cursor property in a derived class, use the base class's Cursor property to extend the base implementation. En caso contrario, debe proporcionar toda la implementación.Otherwise, you must provide all the implementation. No es necesario reemplazar ambos el get y set métodos de la Cursor propiedad; se puede reemplazar sólo uno, si es necesario.You are not required to override both the get and set methods of the Cursor property; you can override only one if needed.

Seguridad

UIPermission
para las ventanas secundarias seguras establecer este valor de propiedad.for safe subwindows to set this property value. Enumeración asociada: SafeSubWindowsAssociated enumeration: SafeSubWindows

Se aplica a

Consulte también: