Control.Cursor Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define o cursor que é exibido quando o ponteiro do mouse está sobre o controle.

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

Cursor

Um Cursor que representa o cursor a ser exibido quando o ponteiro do mouse está sobre o controle.

Exemplos

O exemplo de código a seguir preenche uma ComboBox com as unidades lógicas disponíveis do usuário. O exemplo também define a propriedade da caixa de Cursor combinação para que o Cursors.Hand cursor seja exibido quando o ponteiro do mouse estiver sobre o botão suspenso. Esse código exige que você tenha um Form com um ComboBox sobre ele.

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 uma Cursor à Cursor propriedade do controle para alterar o cursor exibido quando o ponteiro do mouse estiver sobre o controle. Para alterar temporariamente o cursor do mouse para todos os controles em seu aplicativo, defina a Cursor.Current propriedade. Normalmente, você definiria a Cursor.Current propriedade como um cursor de espera ao preencher ou ComboBox salvar ou carregar um arquivo.

A Cursor propriedade é uma propriedade ambiente. Uma propriedade de ambiente é uma propriedade de controle que, se não estiver definida, é recuperada do controle pai. Por exemplo, um Button terá o mesmo BackColor que seu pai Form por padrão. Para obter mais informações sobre propriedades de ambiente, consulte a AmbientProperties classe ou a visão geral da Control classe.

Notas aos Herdeiros

Ao substituir a Cursor propriedade em uma classe derivada, use a propriedade da Cursor classe base para estender a implementação base. Caso contrário, você deve fornecer toda a implementação. Não é necessário substituir os métodos e set os get métodos da Cursor propriedade; você pode substituir apenas um, se necessário.

Confira também

• Cursor
• Cursors