ImageList.Draw 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

繪製所示圖像。

多載

名稱	Description
Draw(Graphics, Point, Int32)	在指定位置繪製指定索引 Graphics 所指示的影像。
Draw(Graphics, Int32, Int32, Int32)	在指定 Graphics 地點繪製所指索引的圖像。
Draw(Graphics, Int32, Int32, Int32, Int32, Int32)	以指定位置與大小繪製給定索引 Graphics 所指示的影像。

Draw(Graphics, Point, Int32)

來源:

ImageList.cs

在指定位置繪製指定索引 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)

來源:

ImageList.cs

在指定 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)

來源:

ImageList.cs

以指定位置與大小繪製給定索引 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。

-或-

索引大於或等於圖片列表中的圖片數量。

備註

影像會根據需要拉伸或壓縮，以符合所提供的界限。