Graphics.DrawIconUnstretched(Icon, Rectangle) Methode

Definition

Zeichnet das Bild, das durch die angegebene Icon dargestellt wird, 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

Icon, um zu zeichnen.

targetRect
Rectangle

Rectangle Struktur, die die Position und Größe des resultierenden Bilds angibt. Das Bild wird nicht so skaliert, dass es an dieses Rechteck angepasst wird, aber seine Originalgröße behält. Wenn das Bild größer als das Rechteck ist, wird es abgeschnitten, damit es hineinpasst.

Ausnahmen

icon ist null.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. 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 dem das Symbol gezeichnet werden soll.

  • Zeichnet das Symbol auf dem Bildschirm.

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

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

Gilt für: