ImageList.Draw 方法

參考

定義

命名空間:: System.Windows.Forms

組件:: System.Windows.Forms.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

描繪指示的影像。

多載

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 按鈕的表單中。此範例假設和 Gone Fishing.bmp 存在於 FeatherTexture.bmp c：\Windows \ 。如果點陣圖不存在於您的系統上，或存在於另一個位置，請據以變更範例。

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。

-或-

索引大於或等於影像清單中的影像計數。

備註

影像會視需要延展或壓縮，以符合所提供的界限。

適用於

ImageList.Draw 方法

定義

多載

Draw(Graphics, Point, Int32)

參數

例外狀況

範例

適用於

Draw(Graphics, Int32, Int32, Int32)

參數

例外狀況

適用於

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

參數

例外狀況

備註

適用於

其他資源