Graphics.DrawIconUnstretched(Icon, Rectangle) メソッド

定義

名前空間:

System.Drawing

アセンブリ:

System.Drawing.Common.dll

パッケージ:

System.Drawing.Common v9.0.0-preview.6.24327.6

ソース:

Graphics.cs

イメージをスケーリングせずに、指定した Icon で表されるイメージを描画します。

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)

パラメーター

icon

Icon

描画する Icon。

targetRect

Rectangle

Rectangle 結果のイメージの場所とサイズを指定する構造体です。 イメージはこの四角形に合わせて拡大縮小されませんが、元のサイズは保持されます。 画像が四角形よりも大きい場合は、その中に収まるようにクリップされます。

例外

ArgumentNullException

icon は nullです。

例

次のコード例は Windows フォームで使用できるように設計されており、Paint イベント ハンドラーのパラメーターである PaintEventArgseが必要です。 このコードは、次のアクションを実行します。

• サンプル フォルダー内の標準の Windows アイコン ファイルSampIcon.icoからアイコンを作成します。

• アイコンを描画する四角形を作成します。

• アイコンを画面に描画します。

四角形の位置は画面上のアイコンを見つけ、描画されたアイコンはスケール解除され、クリップ解除されます。

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