Control.Cursor Propriété

Définition

Obtient ou définit le curseur qui est affiché quand le pointeur de la souris se trouve sur le contrôle.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

Valeur de propriété

Cursor

Cursor qui représente le curseur à afficher quand le pointeur de la souris se trouve sur le contrôle.A Cursor that represents the cursor to display when the mouse pointer is over the control.

Exemples

L’exemple de code suivant remplit un ComboBox avec les lecteurs logiques disponibles de l’utilisateur.The following code example fills a ComboBox with the user's available logical drives. L’exemple définit également la propriété de la zone de liste déroulante Cursor afin que le Cursors.Hand curseur s’affiche lorsque le pointeur de la souris se trouve sur le bouton déroulant.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. Ce code nécessite que vous disposiez d’un Form avec un ComboBox .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

Remarques

Assignez un Cursor à la Cursor propriété du contrôle pour modifier le curseur affiché lorsque le pointeur de la souris se trouve sur le contrôle.Assign a Cursor to the Cursor property of the control to change the cursor displayed when the mouse pointer is over the control. Pour modifier temporairement le curseur de la souris pour tous les contrôles de votre application, définissez la Cursor.Current propriété.To temporarily change the mouse cursor for all controls on your application set the Cursor.Current property. En général, vous définissez la Cursor.Current propriété sur un curseur d’attente lors du remplissage ComboBox ou de l’enregistrement ou du chargement d’un fichier.Typically you would set the Cursor.Current property to a wait cursor when populating a ComboBox or saving or loading a file.

La Cursor propriété est une propriété ambiante.The Cursor property is an ambient property. Une propriété ambiante est une propriété de contrôle qui, si elle n’est pas définie, est récupérée à partir du contrôle parent.An ambient property is a control property that, if not set, is retrieved from the parent control. Par exemple, un Button aura le même BackColor que son parent Form par défaut.For example, a Button will have the same BackColor as its parent Form by default. Pour plus d’informations sur les propriétés ambiantes, consultez la AmbientProperties classe ou Control vue d’ensemble de la classe.For more information about ambient properties, see the AmbientProperties class or the Control class overview.

Notes pour les héritiers

Lors de la substitution de la Cursor propriété dans une classe dérivée, utilisez la propriété de la classe de base Cursor pour étendre l’implémentation de base.When overriding the Cursor property in a derived class, use the base class's Cursor property to extend the base implementation. Sinon, vous devez fournir toute l’implémentation.Otherwise, you must provide all the implementation. Vous n’êtes pas tenu de substituer les get set méthodes et de la Cursor propriété ; vous ne pouvez substituer qu’une seule fois si nécessaire.You are not required to override both the get and set methods of the Cursor property; you can override only one if needed.

S’applique à

Voir aussi