Control.Cursor Property

Definition

获取或设置当鼠标指针位于控件上时显示的光标。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

Property Value

Cursor

一个 Cursor,表示当鼠标指针位于控件上时显示的光标。A Cursor that represents the cursor to display when the mouse pointer is over the control.

Examples

下面的代码示例使用用户的可用逻辑驱动器填充 ComboBoxThe following code example fills a ComboBox with the user's available logical drives. 该示例还设置组合框的 Cursor 属性,因此当鼠标指针位于下拉按钮上时,将显示 Cursors.Hand 光标。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. 此代码要求 Form 上有一个 ComboBoxThis 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

Remarks

Cursor 分配给控件的 Cursor 属性,以更改当鼠标指针位于控件上时显示的光标。Assign a Cursor to the Cursor property of the control to change the cursor displayed when the mouse pointer is over the control. 若要为应用程序上的所有控件暂时更改鼠标光标,请设置 Cursor.Current 属性。To temporarily change the mouse cursor for all controls on your application set the Cursor.Current property. 通常,会在填充 ComboBox 或保存或加载文件时将 Cursor.Current 属性设置为等待光标。Typically you would set the Cursor.Current property to a wait cursor when populating a ComboBox or saving or loading a file.

Cursor 属性是环境属性。The Cursor property is an ambient property. 环境属性是一个控件属性,如果未设置,则将从父控件中检索该属性。An ambient property is a control property that, if not set, is retrieved from the parent control. 例如,默认情况下,Button 将具有与其父 Form 相同的 BackColorFor example, a Button will have the same BackColor as its parent Form by default. 有关环境属性的详细信息,请参阅 AmbientProperties 类或 Control 类概述。For more information about ambient properties, see the AmbientProperties class or the Control class overview.

Notes to Inheritors

在派生类中重写 Cursor 属性时,请使用基类的 Cursor 属性来扩展基实现。When overriding the Cursor property in a derived class, use the base class's Cursor property to extend the base implementation. 否则,必须提供所有实现。Otherwise, you must provide all the implementation. 不需要重写 Cursor 属性的 getset 方法;如果需要,只能重写一个。You are not required to override both the get and set methods of the Cursor property; you can override only one if needed.

Applies to

See also