Graphics.DrawIconUnstretched-Methode

Zeichnet das durch das angegebene Icon dargestellte Bild ohne Skalierung.

Namespace: System.Drawing
Assembly: System.Drawing (in system.drawing.dll)

Syntax

'Declaration
Public Sub DrawIconUnstretched ( _
    icon As Icon, _
    targetRect As Rectangle _
)
'Usage
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
)

Parameter

• icon
  Zu zeichnendes Icon.

• targetRect
  Rectangle-Struktur, die die Position und Größe des resultierenden Bildes angibt. Das Bild wird nicht skaliert, um in dieses Rechteck zu passen, sondern behält seine ursprüngliche Größe bei. Wenn das Bild größer als das Rechteck ist, wird das Bild zum Anpassen abgeschnitten.

Ausnahmen

Beispiel

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms vorgesehen und erfordert PaintEventArgse, wobei es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

• Erstellt ein Symbol aus der Windows-Standardsymboldatei SampIcon.ico im Beispielordner.

• Erstellt ein Rechteck, in dem das Symbol gezeichnet wird.

• Zeichnet das Symbol auf dem Bildschirm.

Die Position des Rechtecks bestimmt die Position des Symbols auf dem Bildschirm, und das gezeichnete Symbol ist weder skaliert noch abgeschnitten.

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 );
   }

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Graphics-Klasse
Graphics-Member
System.Drawing-Namespace