Graphics.DrawIconUnstretched(Icon, Rectangle) Método

Definición

Dibuja la imagen representada por el Icon especificado sin transformar a escala la imagen.Draws the image represented by the specified Icon without scaling the image.

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

Parámetros

icon
Icon

Icon que se va a dibujar.Icon to draw.

targetRect
Rectangle

Estructura Rectangle que especifica la ubicación y el tamaño de la imagen resultante.Rectangle structure that specifies the location and size of the resulting image. No se modifica la escala de la imagen para que encaje en el rectángulo, sino que conserva su tamaño original.The image is not scaled to fit this rectangle, but retains its original size. Si la imagen es mayor que el rectángulo, se recorta para que quepa en él.If the image is larger than the rectangle, it is clipped to fit inside it.

Excepciones

icon es null.icon is null.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que Paint es un parámetro del controlador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. El código realiza las siguientes acciones:The code performs the following actions:

  • Crea un icono a partir de un archivo de icono estándar de Windows SampIcon. ico en la carpeta de ejemplo.Creates an icon from a standard Windows icon file SampIcon.ico in the example folder.

  • Crea un rectángulo en el que dibujar el icono.Creates a rectangle in which to draw the icon.

  • Dibuja el icono en la pantalla.Draws the icon to the screen.

La posición del rectángulo localiza el icono en la pantalla y el icono dibujado no se escala y se recorta.The position of the rectangle locates the icon on the screen, and the drawn icon is unscaled and unclipped.

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