Dibuja la imagen representada por el
Icon especificado sin transformar a escala la imagen.
Espacio de nombres: System.Drawing
Ensamblado: System.Drawing (en system.drawing.dll)
Sintaxis
Visual Basic (Declaración)
Public Sub DrawIconUnstretched ( _
icon As Icon, _
targetRect As Rectangle _
)
Dim instance As Graphics
Dim icon As Icon
Dim targetRect As Rectangle
instance.DrawIconUnstretched(icon, targetRect)
public void DrawIconUnstretched (
Icon icon,
Rectangle targetRect
)
public:
void DrawIconUnstretched (
Icon^ icon,
Rectangle targetRect
)
public void DrawIconUnstretched (
Icon icon,
Rectangle targetRect
)
public function DrawIconUnstretched (
icon : Icon,
targetRect : Rectangle
)
Parámetros
- icon
Icon que se va a dibujar.
- targetRect
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
| Tipo de excepción | Condición |
|---|
ArgumentNullException |
El valor de icon es referencia de objeto null (Nothing en Visual Basic). |
Ejemplo
El siguiente ejemplo está pensado para que se utilice con formularios Windows Forms y requiere PaintEventArgse, que es un parámetro del controlador del evento Paint. El código realiza las siguientes acciones:
-
Crea un icono a partir de un archivo de icono estándar de Windows, SampIcon.ico, en la carpeta del ejemplo.
-
Crea un rectángulo en el que se dibuja el icono.
-
Dibuja el icono en la pantalla.
La posición del rectángulo localiza el icono en la pantalla y la escala original del icono dibujado se restaura, anulando cualquier recorte aplicado.
Public 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
public 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);
}
public:
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 );
}
Plataformas
Windows 98, Windows 2000 SP4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition
.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.
Información de versión
.NET Framework
Compatible con: 2.0, 1.1, 1.0
Vea también