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

Definition

Ruft den Cursor ab, der angezeigt wird, wenn sich der Mauszeiger über dem Steuerelement befindet, oder legt diesen fest.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

Eigenschaftswert

Ein Cursor, der den Cursor darstellt, der angezeigt wird, wenn sich der Mauszeiger über dem Steuerelement befindet.A Cursor that represents the cursor to display when the mouse pointer is over the control.

Beispiele

Im folgenden Codebeispiel wird eine ComboBox mit den verfügbaren logischen Laufwerken des Benutzers gefüllt.The following code example fills a ComboBox with the user's available logical drives. Im Beispiel wird auch die Cursor-Eigenschaft des Kombinations Felds festgelegt, sodass der Cursors.Hand-Cursor angezeigt wird, wenn sich der Mauszeiger über der Dropdown Schaltfläche befindet.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. Für diesen Code ist es erforderlich, dass Sie über eine Form mit einer ComboBox verfügen.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

Hinweise

Weisen Sie der Cursor-Eigenschaft des Steuer Elements einen Cursor zu, um den Cursor zu ändern, der angezeigt wird, wenn sich der Mauszeiger über dem Steuerelement befindet.Assign a Cursor to the Cursor property of the control to change the cursor displayed when the mouse pointer is over the control. Legen Sie zum vorübergehenden Ändern des Mauszeigers für alle Steuerelemente in Ihrer Anwendung die Cursor.Current-Eigenschaft fest.To temporarily change the mouse cursor for all controls on your application set the Cursor.Current property. Normalerweise würden Sie die Cursor.Current-Eigenschaft auf einen Warte Cursor festlegen, wenn Sie eine ComboBox Auffüllen oder eine Datei speichern oder laden.Typically you would set the Cursor.Current property to a wait cursor when populating a ComboBox or saving or loading a file.

Die Cursor-Eigenschaft ist eine Ambient-Eigenschaft.The Cursor property is an ambient property. Eine Ambient-Eigenschaft ist eine Steuerelement Eigenschaft, die, wenn Sie nicht festgelegt ist, vom übergeordneten Steuerelement abgerufen wird.An ambient property is a control property that, if not set, is retrieved from the parent control. Beispielsweise hat die Button standardmäßig dieselbe BackColor wie Ihr übergeordnetes Form.For example, a Button will have the same BackColor as its parent Form by default. Weitere Informationen zu Ambient-Eigenschaften finden Sie in der AmbientProperties-Klasse oder in der Übersicht über die Control-Klasse.For more information about ambient properties, see the AmbientProperties class or the Control class overview.

Hinweise für Vererber

Wenn Sie die Cursor-Eigenschaft in einer abgeleiteten Klasse überschreiben, verwenden Sie die Cursor-Eigenschaft der Basisklasse, um die Basis Implementierung zu erweitern.When overriding the Cursor property in a derived class, use the base class's Cursor property to extend the base implementation. Andernfalls müssen Sie die gesamte-Implementierung bereitstellen.Otherwise, you must provide all the implementation. Es ist nicht erforderlich, die Methoden get und set der Cursor-Eigenschaft zu überschreiben. Sie können bei Bedarf nur eine überschreiben.You are not required to override both the get and set methods of the Cursor property; you can override only one if needed.

Sicherheit

UIPermission
für sichere Unterfenster, um diesen Eigenschafts Wert festzulegen.for safe subwindows to set this property value. Zugehörige Enumeration: SafeSubWindowsAssociated enumeration: SafeSubWindows

Gilt für:

Siehe auch