Control.Cursor Propriedade

Definição

Obtém ou define o cursor que é exibido quando o ponteiro do mouse está sobre o controle.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

Valor da propriedade

Um Cursor que representa o cursor a ser exibido quando o ponteiro do mouse está sobre o controle.A Cursor that represents the cursor to display when the mouse pointer is over the control.

Exemplos

O exemplo de código a seguir preenche um ComboBox com as unidades lógicas disponíveis do usuário.The following code example fills a ComboBox with the user's available logical drives. O exemplo também define a propriedade Cursor da caixa de combinação para que o cursor Cursors.Hand seja exibido quando o ponteiro do mouse estiver sobre o botão suspenso.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. Esse código requer que você tenha um Form com um ComboBox.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

Comentários

Atribua um Cursor à propriedade Cursor do controle para alterar o cursor exibido quando o ponteiro do mouse estiver sobre o controle.Assign a Cursor to the Cursor property of the control to change the cursor displayed when the mouse pointer is over the control. Para alterar temporariamente o cursor do mouse para todos os controles em seu aplicativo, defina a propriedade Cursor.Current.To temporarily change the mouse cursor for all controls on your application set the Cursor.Current property. Normalmente, você definiria a propriedade Cursor.Current como um cursor de espera ao preencher um ComboBox ou salvar ou carregar um arquivo.Typically you would set the Cursor.Current property to a wait cursor when populating a ComboBox or saving or loading a file.

A propriedade Cursor é uma propriedade de ambiente.The Cursor property is an ambient property. Uma propriedade de ambiente é uma propriedade de controle que, se não definida, é recuperada do controle pai.An ambient property is a control property that, if not set, is retrieved from the parent control. Por exemplo, um Button terá o mesmo BackColor que seu Form pai por padrão.For example, a Button will have the same BackColor as its parent Form by default. Para obter mais informações sobre as propriedades de ambiente, consulte a classe AmbientProperties ou a visão geral da classe Control.For more information about ambient properties, see the AmbientProperties class or the Control class overview.

Notas aos Herdeiros

Ao substituir a propriedade Cursor em uma classe derivada, use a propriedade Cursor da classe base para estender a implementação base.When overriding the Cursor property in a derived class, use the base class's Cursor property to extend the base implementation. Caso contrário, você deve fornecer toda a implementação.Otherwise, you must provide all the implementation. Não é necessário substituir os métodos get e set da propriedade Cursor; Você pode substituir apenas um se necessário.You are not required to override both the get and set methods of the Cursor property; you can override only one if needed.

Segurança

UIPermission
para subjanelas seguras para definir esse valor de propriedade.for safe subwindows to set this property value. Enumeração associada: SafeSubWindowsAssociated enumeration: SafeSubWindows

Aplica-se a

Veja também