ImageList.Draw Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Dibuja la imagen indicada.

Sobrecargas

Nombre	Description
Draw(Graphics, Point, Int32)	Dibuja la imagen indicada por el índice especificado en el especificado en la ubicación especificada Graphics .
Draw(Graphics, Int32, Int32, Int32)	Dibuja la imagen indicada por el índice especificado en el especificado en la ubicación especificada Graphics .
Draw(Graphics, Int32, Int32, Int32, Int32, Int32)	Dibuja la imagen indicada por el índice especificado en el especificado Graphics utilizando la ubicación y el tamaño especificados.

Draw(Graphics, Point, Int32)

Source:

ImageList.cs

Dibuja la imagen indicada por el índice especificado en el especificado en la ubicación especificada 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)

Parámetros

g

Graphics

que Graphics se va a dibujar.

pt

Point

Ubicación definida por un Point objeto en el que se va a dibujar la imagen.

index

Int32

Índice de la imagen en la ImageList que se va a dibujar.

Excepciones

ArgumentOutOfRangeException

El índice es menor que 0.

O bien

El índice es mayor o igual que el recuento de imágenes de la lista de imágenes.

Ejemplos

En el ejemplo de código siguiente se muestra cómo construir un ImageList, agregando imágenes a la Images propiedad , estableciendo la ImageSize propiedad y usando el Draw método . Para ejecutar este ejemplo, colóquelo en un formulario que contenga un botón denominado Button1. En el ejemplo se supone la existencia de FeatherTexture.bmp y Gone Fishing.bmp en c:\Windows\. Cambie el ejemplo en consecuencia si los mapas de bits no existen en el sistema o existen en otra ubicación.

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)

Source:

ImageList.cs

Dibuja la imagen indicada por el índice especificado en el especificado en la ubicación especificada 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)

Parámetros

g

Graphics

que Graphics se va a dibujar.

x

Int32

Posición horizontal en la que se va a dibujar la imagen.

y

Int32

Posición vertical en la que se va a dibujar la imagen.

index

Int32

Índice de la imagen en la ImageList que se va a dibujar.

Excepciones

ArgumentOutOfRangeException

El índice es menor que 0.

O bien

El índice es mayor o igual que el recuento de imágenes de la lista de imágenes.

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

Source:

ImageList.cs

Dibuja la imagen indicada por el índice especificado en el especificado Graphics utilizando la ubicación y el tamaño 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

que Graphics se va a dibujar.

x

Int32

Posición horizontal en la que se va a dibujar la imagen.

y

Int32

Posición vertical en la que se va a dibujar la imagen.

width

Int32

Ancho, en píxeles, de la imagen de destino.

height

Int32

Alto, en píxeles, de la imagen de destino.

index

Int32

Índice de la imagen en la ImageList que se va a dibujar.

Excepciones

ArgumentOutOfRangeException

El índice es menor que 0.

O bien

El índice es mayor o igual que el recuento de imágenes de la lista de imágenes.

Comentarios

La imagen se estira o comprime según sea necesario para ajustarse a los límites proporcionados.