ImageList.Draw 方法

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

绘制指示的图像。

重载

Draw(Graphics, Point, Int32)	在指定 Graphics 上的给定位置绘制指定索引所指示的图像。
Draw(Graphics, Int32, Int32, Int32)	在指定 Graphics 上的指定位置绘制给定索引所指示的图像。
Draw(Graphics, Int32, Int32, Int32, Int32, Int32)	使用指定的位置和大小绘制由指定的 Graphics 的给定索引所指示的图像。

Draw(Graphics, Point, Int32)

在指定 Graphics 上的给定位置绘制指定索引所指示的图像。

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

要进行绘制的 Graphics。

pt

Point

Point 定义的绘制图像的位置。

index

Int32

要绘制的 ImageList 中的图像的索引。

例外

ArgumentOutOfRangeException

索引小于 0。

- 或 -

索引大于或等于图像列表中图像的计数。

示例

下面的代码示例演示如何构造 ImageList、将图像添加到 Images 属性、设置 ImageSize 属性以及使用 Draw 方法。 若要运行此示例，请将其放置在包含名为 的按钮的 Button1窗体中。 该示例假定 c：\Windows\ 中存在 FeatherTexture.bmp 和 Gone Fishing.bmp 。 如果系统中不存在位图或位于其他位置，请相应地更改示例。

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

Draw(Graphics, Int32, Int32, Int32)

在指定 Graphics 上的指定位置绘制给定索引所指示的图像。

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

要进行绘制的 Graphics。

x

Int32

图像绘制处的水平位置。

y

Int32

图像绘制处的垂直位置。

index

Int32

要绘制的 ImageList 中的图像的索引。

例外

ArgumentOutOfRangeException

索引小于 0。

- 或 -

索引大于或等于图像列表中图像的计数。

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

使用指定的位置和大小绘制由指定的 Graphics 的给定索引所指示的图像。

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

要进行绘制的 Graphics。

x

Int32

图像绘制处的水平位置。

y

Int32

图像绘制处的垂直位置。

width

Int32

目标图像的宽度（以像素为单位）。

height

Int32

目标图像的高度（以像素为单位）。

index

Int32

要绘制的 ImageList 中的图像的索引。

例外

ArgumentOutOfRangeException

索引小于 0。

- 或 -

索引大于或等于图像列表中图像的计数。

注解

根据需要拉伸或压缩图像以适应提供的边界。