Control.Cursor Propiedad

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

En el ejemplo de código siguiente se rellena un ComboBox con las unidades lógicas disponibles del usuario.The following code example fills a ComboBox with the user's available logical drives. En el ejemplo también se establece la propiedad Cursor del cuadro combinado para que se muestre el cursor Cursors.Hand cuando el puntero del mouse se encuentra sobre el botón 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 tenga 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

Asigne un Cursor a la propiedad Cursor del control para cambiar el cursor que se muestra cuando el puntero del mouse se sitúa sobre el 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 de la aplicación, establezca la propiedad Cursor.Current.To temporarily change the mouse cursor for all controls on your application set the Cursor.Current property. Normalmente, se establece la propiedad Cursor.Current en 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.

La propiedad 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 se establece, se recupera del 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 que el 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 sobre las propiedades de ambiente, vea la clase AmbientProperties o la información general sobre la clase Control.For more information about ambient properties, see the AmbientProperties class or the Control class overview.

Notas a los desarrolladores de herederos

Al reemplazar la propiedad Cursor en una clase derivada, use la propiedad Cursor de la clase base 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. De lo contrario, debe proporcionar toda la implementación.Otherwise, you must provide all the implementation. No es necesario que invalide los métodos get y set de la propiedad Cursor; solo puede invalidar una 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 que las subventanas seguras establezcan este valor de propiedad.for safe subwindows to set this property value. Enumeración asociada: SafeSubWindowsAssociated enumeration: SafeSubWindows

Se aplica a

Consulte también: