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

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 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 Cursor zone de liste Cursors.Hand déroulante afin que le 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 Form d’un ComboBox avec un.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 Cursor un Cursor à la 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 Cursor.Current application, définissez la 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 Cursor.Current la propriété sur un curseur d’attente lors ComboBox du remplissage 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 AmbientProperties , consultez la Control classe ou 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 Cursor de la propriété dans une classe dérivée, utilisez la Cursor propriété de la classe de base 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 méthodes set 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écurité

UIPermission
pour que les sous-fenêtres sécurisées définissent cette valeur de propriété.for safe subwindows to set this property value. Énumération associée:SafeSubWindowsAssociated enumeration: SafeSubWindows

S’applique à

Voir aussi