Partilhar via


ImageList.Draw Método

Definição

Desenha a imagem indicada.

Sobrecargas

Draw(Graphics, Point, Int32)

Desenha a imagem indicada pelo índice no usuário Graphics especificado na localização determinada.

Draw(Graphics, Int32, Int32, Int32)

Desenha a imagem indicada pelo índice especificado no Graphics especificado no local especificado.

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

Desenha a imagem indicada pelo índice especificado no Graphics especificado usando o local e o tamanho especificados.

Draw(Graphics, Point, Int32)

Desenha a imagem indicada pelo índice no usuário Graphics especificado na localização determinada.

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)

Parâmetros

g
Graphics

O Graphics para desenhar.

pt
Point

A localização definida por um Point na qual desenhar a imagem.

index
Int32

O índice da imagem no ImageList a ser desenhada.

Exceções

O índice é menor que 0.

- ou -

O índice especificado é maior ou igual à contagem de imagens na lista de imagens.

Exemplos

O exemplo de código a seguir demonstra a construção de uma ImageList, adicionando imagens à Images propriedade, definindo a ImageSize propriedade e usando o Draw método. Para executar este exemplo, coloque-o em um formulário que contém um botão chamado Button1. O exemplo pressupõe a existência de FeatherTexture.bmp e Gone Fishing.bmp em c:\Windows\. Altere o exemplo de acordo se os bitmaps não existirem em seu sistema ou existirem em outro local.

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

Aplica-se a

Draw(Graphics, Int32, Int32, Int32)

Desenha a imagem indicada pelo índice especificado no Graphics especificado no local especificado.

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)

Parâmetros

g
Graphics

O Graphics para desenhar.

x
Int32

A posição horizontal na qual desenhar a imagem.

y
Int32

A posição vertical na qual desenhar a imagem.

index
Int32

O índice da imagem no ImageList a ser desenhada.

Exceções

O índice é menor que 0.

- ou -

O índice especificado é maior ou igual à contagem de imagens na lista de imagens.

Aplica-se a

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

Desenha a imagem indicada pelo índice especificado no Graphics especificado usando o local e o tamanho especificados.

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)

Parâmetros

g
Graphics

O Graphics para desenhar.

x
Int32

A posição horizontal na qual desenhar a imagem.

y
Int32

A posição vertical na qual desenhar a imagem.

width
Int32

A largura, em pixels, da imagem de destino.

height
Int32

A altura, em pixels, da imagem de destino.

index
Int32

O índice da imagem no ImageList a ser desenhada.

Exceções

O índice é menor que 0.

- ou -

O índice especificado é maior ou igual à contagem de imagens na lista de imagens.

Comentários

A imagem é estendida ou compactada conforme necessário para se ajustar aos limites fornecidos.

Aplica-se a