Graphics.DrawIconUnstretched(Icon, Rectangle) Method


Формирует изображение, представленное указанным объектом Icon, без его масштабирования.Draws the image represented by the specified Icon without scaling the image.

 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)



Объект Icon для рисования.Icon to draw.


Структура Rectangle, которая задает расположение и размер создаваемого изображения.Rectangle structure that specifies the location and size of the resulting image. Изображение не масштабируется до размеров данного прямоугольника и сохраняет свой исходный размер.The image is not scaled to fit this rectangle, but retains its original size. Если изображение больше этого прямоугольника, то оно обрезается до его размеров.If the image is larger than the rectangle, it is clipped to fit inside it.


Параметр icon равен null.icon is null.


Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Код выполняет следующие действия.The code performs the following actions:

  • Создает значок из стандартного файла значка Windows Сампикон. ico в папке example.Creates an icon from a standard Windows icon file SampIcon.ico in the example folder.

  • Создает прямоугольник, в котором рисуется значок.Creates a rectangle in which to draw the icon.

  • Отображает значок на экране.Draws the icon to the screen.

Положение прямоугольника определяет значок на экране, а рисуемый значок — немасштабируемый и необрезанный.The position of the rectangle locates the icon on the screen, and the drawn icon is unscaled and unclipped.

   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

Applies to