ImageList.Draw メソッド

定義

示されたイメージを描画します。Draws the indicated image.

オーバーロード

Draw(Graphics, Point, Int32)

特定の Graphics 上の指定された位置で、指定されたインデックスによって示されたイメージを描画します。Draws the image indicated by the specified index on the specified Graphics at the given location.

Draw(Graphics, Int32, Int32, Int32)

特定の Graphics 上の指定された位置で、特定のインデックスによって示されたイメージを描画します。Draws the image indicated by the given index on the specified Graphics at the specified location.

Draw(Graphics, Int32, Int32, Int32, Int32, Int32)

特定の Graphics の指定した位置に、特定のインデックスで示されたイメージを、指定したサイズで描画します。Draws the image indicated by the given index on the specified Graphics using the specified location and size.

Draw(Graphics, Point, Int32)

特定の Graphics 上の指定された位置で、指定されたインデックスによって示されたイメージを描画します。Draws the image indicated by the specified index on the specified Graphics at the given location.

public:
 void Draw(System::Drawing::Graphics ^ g, System::Drawing::Point pt, int index);
public void Draw (System.Drawing.Graphics g, System.Drawing.Point pt, int index);
member this.Draw : System.Drawing.Graphics * System.Drawing.Point * int -> unit
Public Sub Draw (g As Graphics, pt As Point, index As Integer)

パラメーター

g
Graphics

描画する GraphicsThe Graphics to draw on.

pt
Point

Point によって定義された、イメージを描画する位置。The location defined by a Point at which to draw the image.

index
Int32

描画する ImageList 内のイメージのインデックス。The index of the image in the ImageList to draw.

例外

インデックスが 0 未満です。The index is less than 0.

- または --or-

インデックスが、イメージ リスト内のイメージ数以上の値になっています。The index is greater than or equal to the count of images in the image list.

を構築 ImageList し、プロパティにイメージを追加し、 Images プロパティを設定し、 ImageSize メソッドを使用するコード例を次に示し Draw ます。The following code example demonstrates constructing an ImageList, adding images to the Images property, setting the ImageSize property, and using the Draw method. この例を実行するには、という名前のボタンを含むフォームに配置し Button1 ます。To run this example, place it in a form containing a button named Button1. この例では、とが c:\Windows に存在することを前提としてい FeatherTexture.bmp Gone Fishing.bmp \ ます。The example assumes the existence of FeatherTexture.bmp and Gone Fishing.bmp at c:\Windows\. ビットマップがシステムに存在しない場合、または別の場所に存在する場合は、適宜、この例を変更します。Change the example accordingly if the bitmaps do not exist on your system, or exist at another location.

internal:
   System::Windows::Forms::ImageList^ ImageList1;

private:

   // Create an ImageList Object, populate it, and display
   // the images it contains.
   void Button1_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      
      // Construct the ImageList.
      ImageList1 = gcnew ImageList;
      
      // Set the ImageSize property to a larger size 
      // (the default is 16 x 16).
      ImageList1->ImageSize = System::Drawing::Size( 112, 112 );
      
      // Add two images to the list.
      ImageList1->Images->Add( Image::FromFile( "c:\\windows\\FeatherTexture.bmp" ) );
      ImageList1->Images->Add( Image::FromFile( "C:\\windows\\Gone Fishing.bmp" ) );
      
      // Get a Graphics object from the form's handle.
      Graphics^ theGraphics = Graphics::FromHwnd( this->Handle );
      
      // Loop through the images in the list, drawing each image.
      for ( int count = 0; count < ImageList1->Images->Count; count++ )
      {
         ImageList1->Draw( theGraphics, Point(85,85), count );
         
         // Call Application.DoEvents to force a repaint of the form.
         Application::DoEvents();
         
         // Call the Sleep method to allow the user to see the image.
         System::Threading::Thread::Sleep( 1000 );

      }
   }
internal System.Windows.Forms.ImageList ImageList1;

// Create an ImageList Object, populate it, and display
// the images it contains.
private void Button1_Click(System.Object sender, 
    System.EventArgs e)
{

    // Construct the ImageList.
    ImageList1 = new ImageList();

    // Set the ImageSize property to a larger size 
    // (the default is 16 x 16).
    ImageList1.ImageSize = new Size(112, 112);

    // Add two images to the list.
    ImageList1.Images.Add(
        Image.FromFile("c:\\windows\\FeatherTexture.bmp"));
    ImageList1.Images.Add(
        Image.FromFile("C:\\windows\\Gone Fishing.bmp"));

    // Get a Graphics object from the form's handle.
    Graphics theGraphics = Graphics.FromHwnd(this.Handle);

    // Loop through the images in the list, drawing each image.
    for(int count = 0; count < ImageList1.Images.Count; count++)
    {
        ImageList1.Draw(theGraphics, new Point(85, 85), count);

        // Call Application.DoEvents to force a repaint of the form.
        Application.DoEvents();

        // Call the Sleep method to allow the user to see the image.
        System.Threading.Thread.Sleep(1000);
    }
}

Friend WithEvents ImageList1 As System.Windows.Forms.ImageList

' Create an ImageList Object, populate it, and display
' the images it contains.
Private Sub Button1_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button1.Click

    ' Construct the ImageList.
    ImageList1 = New ImageList

    ' Set the ImageSize property to a larger size 
    ' (the default is 16 x 16).
    ImageList1.ImageSize = New Size(112, 112)

    ' Add two images to the list.
    ImageList1.Images.Add(Image.FromFile _
        ("c:\windows\FeatherTexture.bmp"))
    ImageList1.Images.Add _
        (Image.FromFile("C:\windows\Gone Fishing.bmp"))

    Dim count As System.Int32

    ' Get a Graphics object from the form's handle.
    Dim theGraphics As Graphics = Graphics.FromHwnd(Me.Handle)

    ' Loop through the images in the list, drawing each image.
    For count = 0 To ImageList1.Images.Count - 1
        ImageList1.Draw(theGraphics, New Point(85, 85), count)

        ' Call Application.DoEvents to force a repaint of the form.
        Application.DoEvents()

        ' Call the Sleep method to allow the user to see the image.
        System.Threading.Thread.Sleep(1000)
    Next
End Sub

適用対象

製品 Introduced

Draw(Graphics, Int32, Int32, Int32)

特定の Graphics 上の指定された位置で、特定のインデックスによって示されたイメージを描画します。Draws the image indicated by the given index on the specified Graphics at the specified location.

public:
 void Draw(System::Drawing::Graphics ^ g, int x, int y, int index);
public void Draw (System.Drawing.Graphics g, int x, int y, int index);
member this.Draw : System.Drawing.Graphics * int * int * int -> unit
Public Sub Draw (g As Graphics, x As Integer, y As Integer, index As Integer)

パラメーター

g
Graphics

描画する GraphicsThe Graphics to draw on.

x
Int32

イメージの描画先の水平位置。The horizontal position at which to draw the image.

y
Int32

イメージの描画先の垂直位置。The vertical position at which to draw the image.

index
Int32

描画する ImageList 内のイメージのインデックス。The index of the image in the ImageList to draw.

例外

インデックスが 0 未満です。The index is less than 0.

- または --or-

インデックスが、イメージ リスト内のイメージ数以上の値になっています。The index is greater than or equal to the count of images in the image list.

適用対象

製品 Introduced

Draw(Graphics, Int32, Int32, Int32, Int32, Int32)

特定の Graphics の指定した位置に、特定のインデックスで示されたイメージを、指定したサイズで描画します。Draws the image indicated by the given index on the specified Graphics using the specified location and size.

public:
 void Draw(System::Drawing::Graphics ^ g, int x, int y, int width, int height, int index);
public void Draw (System.Drawing.Graphics g, int x, int y, int width, int height, int index);
member this.Draw : System.Drawing.Graphics * int * int * int * int * int -> unit
Public Sub Draw (g As Graphics, x As Integer, y As Integer, width As Integer, height As Integer, index As Integer)

パラメーター

g
Graphics

描画する GraphicsThe Graphics to draw on.

x
Int32

イメージの描画先の水平位置。The horizontal position at which to draw the image.

y
Int32

イメージの描画先の垂直位置。The vertical position at which to draw the image.

width
Int32

描画するイメージの幅 (ピクセル単位)。The width, in pixels, of the destination image.

height
Int32

描画するイメージの高さ (ピクセル単位)。The height, in pixels, of the destination image.

index
Int32

描画する ImageList 内のイメージのインデックス。The index of the image in the ImageList to draw.

例外

インデックスが 0 未満です。The index is less than 0.

- または --or-

インデックスが、イメージ リスト内のイメージ数以上の値になっています。The index is greater than or equal to the count of images in the image list.

注釈

指定された範囲に合うように、必要に応じてイメージが拡大または縮小されます。The image is stretched or compressed as necessary to fit the bounds provided.

適用対象

製品 Introduced