Graphics.DrawIconUnstretched(Icon, Rectangle) Método

  • Referencia

Definición

Espacio de nombres:
System.Drawing
Ensamblado:
System.Drawing.Common.dll
Ensamblado:
System.Drawing.dll
Paquete:
System.Drawing.Common v8.0.7
Paquete:
System.Drawing.Common v9.0.0-preview.6.24327.6
Source:
Graphics.cs
Source:
Graphics.cs
Source:
Graphics.cs
Source:
Graphics.cs
Source:
Graphics.cs

Dibuja la imagen representada por el Icon especificado sin escalar 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 dibujar.

targetRect
Rectangle

Rectangle estructura que especifica la ubicación y el tamaño de la imagen resultante. La imagen no se escala para ajustarse a este rectángulo, pero conserva su tamaño original. Si la imagen es mayor que el rectángulo, se recorta para caber dentro de ella.

Excepciones

ArgumentNullException

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 controlador de eventos Paint. 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 y se anula.

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