Control.Cursor Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den Cursor ab, der angezeigt wird, wenn sich der Mauszeiger über dem Steuerelement befindet, oder legt diesen fest.

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

Eigenschaftswert

Cursor

Ein Cursor, der den Cursor darstellt, der angezeigt wird, wenn sich der Mauszeiger über dem Steuerelement befindet.

Beispiele

Im folgenden Codebeispiel wird ein ComboBox Füllpunkt mit den verfügbaren logischen Laufwerken des Benutzers ausgefüllt. Im Beispiel wird auch die Eigenschaft des Kombinationsfelds Cursor festgelegt, sodass der Cursor angezeigt wird, wenn der Cursors.Hand Mauszeiger über die Dropdownschaltfläche liegt. Dieser Code erfordert, dass Sie über eine Form ComboBox Datei verfügen.

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

Hinweise

Weisen Sie der Cursor Eigenschaft des Steuerelements eine Cursor Änderung des Cursors zu, der angezeigt wird, wenn der Mauszeiger über das Steuerelement liegt. Um den Mauszeiger für alle Steuerelemente in Ihrer Anwendung vorübergehend zu ändern, legen Sie die Cursor.Current Eigenschaft fest. Normalerweise würden Sie die Cursor.Current Eigenschaft auf einen Wartenzeiger festlegen, wenn sie eine ComboBox Datei auffüllen oder speichern oder laden.

Die Cursor Eigenschaft ist eine Umgebungseigenschaft. Eine Umgebungseigenschaft ist eine Steuerelementeigenschaft, die, wenn nicht festgelegt, aus dem übergeordneten Steuerelement abgerufen wird. Beispielsweise hat ein Button Element standardmäßig das gleiche BackColor wie sein übergeordnetes Form Element. Weitere Informationen zu Umgebungseigenschaften finden Sie in der AmbientProperties Klassen- oder Klassenübersicht Control .

Hinweise für Vererber

Verwenden Sie beim Außerkraftsetzen der Eigenschaft in einer abgeleiteten Klasse die Cursor Basisklasse, um die Basisimplementierung Cursor zu erweitern. Andernfalls müssen Sie alle Implementierungen bereitstellen. Sie sind nicht erforderlich, um sowohl die Methoden als auch die get set Methoden der Cursor Eigenschaft außer Kraft zu setzen. Sie können nur eine bei Bedarf außer Kraft setzen.

Gilt für

Produkt	Versionen
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
Windows Desktop	3.0, 3.1, 5, 6, 7

Freigeben über