Cursor.Dispose Cursor.Dispose Cursor.Dispose Cursor.Dispose Method

Definición

Libera todos los recursos que usa Cursor.Releases all resources used by the Cursor.

public:
 virtual void Dispose();
public void Dispose ();
abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit
Public Sub Dispose ()

Implementaciones

Ejemplos

En el ejemplo de código siguiente se dibuja el cursor especificado en el formulario con su tamaño normal y, en modo ajustado, dos veces su tamaño.The following code example draws the specified cursor on the form in its normal size, and in stretched mode, twice its size. Este ejemplo requiere un Form y un Cursor para pasar al método cuando se llama.This example requires a Form and a Cursor to pass into the method when it is called.

void DrawCursorsOnForm( System::Windows::Forms::Cursor^ cursor )
{
   
   // If the form's cursor is not the Hand cursor and the
   // Current cursor is the Default, Draw the specified
   // cursor on the form in normal size and twice normal size.
   if ( this->Cursor != Cursors::Hand && System::Windows::Forms::Cursor::Current == Cursors::Default )
   {
      
      // Draw the cursor stretched.
      Graphics^ graphics = this->CreateGraphics();
      Rectangle rectangle = Rectangle(Point(10,10),System::Drawing::Size( cursor->Size.Width * 2, cursor->Size.Height * 2 ));
      cursor->DrawStretched( graphics, rectangle );
      
      // Draw the cursor in normal size.
      rectangle.Location = Point(rectangle.Width + rectangle.Location.X,rectangle.Height + rectangle.Location.Y);
      rectangle.Size = cursor->Size;
      cursor->Draw( graphics, rectangle );
      
      // Dispose of the cursor.
      delete cursor;
   }
}
private void DrawCursorsOnForm(Cursor cursor)
{
   // If the form's cursor is not the Hand cursor and the 
   // Current cursor is the Default, Draw the specified 
   // cursor on the form in normal size and twice normal size.
   if(this.Cursor != Cursors.Hand & 
     Cursor.Current == Cursors.Default)
   {
      // Draw the cursor stretched.
      Graphics graphics = this.CreateGraphics();
      Rectangle rectangle = new Rectangle(
        new Point(10,10), new Size(cursor.Size.Width * 2, 
        cursor.Size.Height * 2));
      cursor.DrawStretched(graphics, rectangle);
		
      // Draw the cursor in normal size.
      rectangle.Location = new Point(
      rectangle.Width + rectangle.Location.X, 
        rectangle.Height + rectangle.Location.Y);
      rectangle.Size = cursor.Size;
      cursor.Draw(graphics, rectangle);

      // Dispose of the cursor.
      cursor.Dispose();
   }
}
Private Sub DrawCursorsOnForm(cursor As Cursor)
   ' If the form's cursor is not the Hand cursor and the 
   ' Current cursor is the Default, Draw the specified 
   ' cursor on the form in normal size and twice normal size. 
   If (Not Me.Cursor.Equals(Cursors.Hand)) And _
     Cursor.Current.Equals(Cursors.Default) Then

      ' Draw the cursor stretched.
      Dim graphics As Graphics = Me.CreateGraphics()
      Dim rectangle As New Rectangle(New Point(10, 10), _
        New Size(cursor.Size.Width * 2, cursor.Size.Height * 2))
      cursor.DrawStretched(graphics, rectangle)
     
      ' Draw the cursor in normal size.
      rectangle.Location = New Point(rectangle.Width + _
        rectangle.Location.X, rectangle.Height + rectangle.Location.Y)
      rectangle.Size = cursor.Size
      cursor.Draw(graphics, rectangle)

      ' Dispose of the cursor.
      cursor.Dispose()
   End If
End Sub

Comentarios

Llame a Dispose cuando haya terminado de usar Cursor.Call Dispose when you are finished using the Cursor. El método Dispose deja el Cursor en un estado no utilizable.The Dispose method leaves the Cursor in an unusable state. Después de llamar a Dispose, debe liberar todas las referencias a la Cursor por lo que el recolector de elementos no utilizados pueda reclamar la memoria que el Cursor estaba ocupando.After calling Dispose, you must release all references to the Cursor so the garbage collector can reclaim the memory that the Cursor was occupying. Para obtener más información, consulte limpiar recursos no administrados y implementar un método Dispose.For more information, see Cleaning Up Unmanaged Resources and Implementing a Dispose Method.

Nota

Realice siempre una llamada a Dispose antes de liberar la última referencia al objeto Cursor.Always call Dispose before you release your last reference to the Cursor. En caso contrario, los recursos que utiliza no se liberarán hasta que la libere el recolector de elementos no utilizados.Otherwise, the resources it is using will not be freed until the garbage collector frees it.

Se aplica a