Graphics.DrawIconUnstretched メソッド

.NET Framework クラス ライブラリ リファレンス

Graphics.DrawIconUnstretched メソッド

指定した Icon によって表されるイメージをスケーリングしないで描画します。

名前空間: System.Drawing
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public Sub DrawIconUnstretched ( _
    icon As Icon, _
    targetRect As Rectangle _
)

Visual Basic (使用法)

Dim instance As Graphics
Dim icon As Icon
Dim targetRect As Rectangle

instance.DrawIconUnstretched(icon, targetRect)

C#

public void DrawIconUnstretched (
    Icon icon,
    Rectangle targetRect
)

C++

public:
void DrawIconUnstretched (
    Icon^ icon, 
    Rectangle targetRect
)

J#

public void DrawIconUnstretched (
    Icon icon, 
    Rectangle targetRect
)

JScript

public function DrawIconUnstretched (
    icon : Icon, 
    targetRect : Rectangle
)

パラメータ

icon

描画する Icon。

targetRect

生成イメージの場所とサイズを指定する Rectangle 構造体。イメージはこの四角形に合わせてスケーリングされず、元のサイズが保持されます。イメージが四角形より大きい場合は、その四角形に収まるようにクリッピングされます。

例外

例外の種類	条件
ArgumentNullException	icon が null 参照 (Visual Basic では Nothing) です。

使用例

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

• この例が保存されているフォルダにある標準の Windows アイコン ファイル SampIcon.ico からアイコンを作成します。

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

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

四角形の位置によって画面上のアイコンの場所が決まります。描画したアイコンはスケーリングもクリッピングもされません。

Visual Basic

Public 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

C#

public 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);
}

C++

public:
   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 );
   }

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Graphics クラス
Graphics メンバ
System.Drawing 名前空間