Graphics.DrawIconUnstretched(Icon, Rectangle) 메서드


이미지의 크기 조정 없이 지정된 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와 함께 사용 하도록 설계 되었으며 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 아이콘 파일 SampIcon에서 아이콘을 만듭니다.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

적용 대상