Graphics.DrawIconUnstretched(Icon, Rectangle) Methode

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Quelle:

Graphics.cs

Zeichnet das durch das angegebene Icon dargestellte Bild, ohne das Bild zu skalieren.

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)

Parameter

icon

Icon

Der zu zeichnende Icon.

targetRect

Rectangle

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

ArgumentNullException

icon ist null.

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, was ein Parameter des Paint Ereignishandlers ist. Der Code führt die folgenden Aktionen aus:

• Erstellt ein Symbol aus einer Standardmäßigen Windows-Symboldatei SampIcon.ico im Beispielordner.

• Erstellt ein Rechteck, in das das Symbol gezeichnet werden soll.

• Zeichnet das Symbol auf den Bildschirm.

Die Position des Rechtecks sucht das Symbol auf dem Bildschirm, und das gezeichnete Symbol ist nicht skaliert und nicht geknappt.

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