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

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.

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.

適用於