Control.Cursor-Eigenschaft

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

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Overridable Property Cursor As Cursor
'Usage
Dim instance As Control
Dim value As Cursor

value = instance.Cursor

instance.Cursor = value

public virtual Cursor Cursor { get; set; }

public:
virtual property Cursor^ Cursor {
    Cursor^ get ();
    void set (Cursor^ value);
}

/** @property */
public Cursor get_Cursor ()

/** @property */
public void set_Cursor (Cursor value)

public function get Cursor () : Cursor

public function set Cursor (value : Cursor)

Eigenschaftenwert

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

Hinweise

Ordnen Sie der Cursor-Eigenschaft des Steuerelements einen Cursor zu, um den Cursor zu ändern, der angezeigt wird, wenn sich der Mauszeiger über dem Steuerelement befindet. Um den Mauszeiger für alle Steuerelemente in der Anwendung vorübergehend zu ändern, legen Sie die Cursor.Current-Eigenschaft fest. Üblicherweise legen Sie für die Cursor.Current-Eigenschaft einen Wartecursor fest, wenn eine ComboBox gefüllt oder eine Datei gespeichert oder geladen wird.

Die Cursor-Eigenschaft ist eine Ambient-Eigenschaft. Eine Ambient-Eigenschaft ist eine Steuerelementeigenschaft, die vom übergeordneten Steuerelement abgerufen wird, sofern sie nicht festgelegt ist. Ein Button hat z. B. standardmäßig die gleiche BackColor wie das übergeordnete Form. Weitere Informationen zu Ambient-Eigenschaften finden Sie unter der AmbientProperties-Klasse oder in der Übersicht über die Control-Klasse.

Hinweise für Erben Verwenden Sie beim Überschreiben der Cursor-Eigenschaft in einer abgeleiteten Klasse die Cursor-Eigenschaft der Basisklasse, um die Basisimplementierung zu erweitern. Andernfalls müssen Sie die gesamte Implementierung bereitstellen. Sie müssen nicht sowohl die get-Methode als auch die set-Methode der Cursor-Eigenschaft überschreiben. Sie können ggf. auch nur eine Methode überschreiben.

Beispiel

Im folgenden Codebeispiel wird eine ComboBox mit den verfügbaren logischen Laufwerken des Benutzers gefüllt. Weiterhin wird im Beispiel die Cursor-Eigenschaft des Kombinationsfelds festgelegt, sodass der Cursors.Hand-Cursor angezeigt wird, wenn sich der Mauszeiger über der Dropdown-Schaltfläche befindet. Bei diesem Codebeispiel muss in einem Form eine ComboBox vorhanden sein.

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

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:
   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.set_Cursor(Cursors.get_Hand());
    // Fill the combo box with all the logical 
    // drives available to the user.
    try {
        for (int iCtr = 0; iCtr < Environment.GetLogicalDrives().
            get_Length(); iCtr++) {
            String logicalDrive = Environment.GetLogicalDrives()[iCtr];
            comboBox1.get_Items().Add(logicalDrive);
        }
    }
    catch (System.Exception ex) {
        MessageBox.Show(ex.get_Message());
    }
} //Form1_Load

.NET Framework-Sicherheit

• UIPermission  für sichere untergeordnete Fenster zum Festlegen dieses Eigenschaftenwerts. Zugeordnete Enumeration: UIPermissionWindow.SafeSubWindows

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Control-Klasse
Control-Member
System.Windows.Forms-Namespace
Cursor
Cursors