Graphics.DrawIconUnstretched(Icon, Rectangle) Método

Definición

Dibuja la imagen representada por el Icon especificado sin transformar a escala la imagen.

public:
 void DrawIconUnstretched(System::Drawing::Icon ^ icon, System::Drawing::Rectangle targetRect);
public void DrawIconUnstretched (System.Drawing.Icon icon, System.Drawing.Rectangle targetRect);
member this.DrawIconUnstretched : System.Drawing.Icon * System.Drawing.Rectangle -> unit
Public Sub DrawIconUnstretched (icon As Icon, targetRect As Rectangle)

Parámetros

icon
Icon

Icon que se va a dibujar.

targetRect
Rectangle

Estructura Rectangle que especifica la ubicación y el tamaño de la imagen resultante. No se modifica la escala de la imagen para que encaje en el rectángulo, sino que conserva su tamaño original. Si la imagen es mayor que el rectángulo, se recorta para que quepa en él.

Excepciones

icon es null.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del Paint controlador de eventos. El código realiza las siguientes acciones:

  • Crea un icono a partir de un archivo de icono de Windows estándar SampIcon.ico en la carpeta de ejemplo.

  • Crea un rectángulo en el que se va a dibujar el icono.

  • Dibuja el icono en la pantalla.

La posición del rectángulo localiza el icono en la pantalla y el icono dibujado no se escala ni se recorta.

private:
   void DrawIconUnstretchedRectangle( PaintEventArgs^ e )
   {

      // Create icon.
      System::Drawing::Icon^ newIcon = gcnew System::Drawing::Icon( "SampIcon.ico" );

      // Create rectangle for icon.
      Rectangle rect = Rectangle(100,100,200,200);

      // Draw icon to screen.
      e->Graphics->DrawIconUnstretched( newIcon, rect );
   }
private void DrawIconUnstretchedRectangle(PaintEventArgs e)
{
    // Create icon.
    Icon newIcon = new Icon("SampIcon.ico");
             
    // Create rectangle for icon.
    Rectangle rect = new Rectangle(100, 100, 200, 200);
             
    // Draw icon to screen.
    e.Graphics.DrawIconUnstretched(newIcon, rect);
}
Private Sub DrawIconUnstretchedRectangle(ByVal e As PaintEventArgs)

    ' Create icon.
    Dim newIcon As New Icon("SampIcon.ico")

    ' Create rectangle for icon.
    Dim rect As New Rectangle(100, 100, 200, 200)

    ' Draw icon to screen.
    e.Graphics.DrawIconUnstretched(newIcon, rect)
End Sub

Se aplica a