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)



描画する IconIcon 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.


iconnullです。icon is null.

次のコード例は、Windows フォームで使用するように設計されてい 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 アイコンファイル Samを持つアイコンを作成します。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