Graphics.DrawIconUnstretched(Icon, Rectangle) Graphics.DrawIconUnstretched(Icon, Rectangle) Graphics.DrawIconUnstretched(Icon, Rectangle) Method

Определение

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

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

Параметры

icon
Icon Icon Icon

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

targetRect
Rectangle Rectangle Rectangle

Структура 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 и требует PaintEventArgs e, что 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.

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

Применяется к