Compartir vía

ImageList.Draw Método

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Dibuja la imagen indicada.

Sobrecargas

Draw(Graphics, Point, Int32)

Dibuja la imagen indicada por el índice especificado, en el objeto Graphics indicado y en la ubicación dada.
Draw(Graphics, Int32, Int32, Int32)

Dibuja la imagen indicada por el índice especificado, en el objeto Graphics indicado y en la ubicación dada.
Draw(Graphics, Int32, Int32, Int32, Int32, Int32)

Se dibuja la imagen indicada por el índice especificado en el objeto Graphics indicado, en la ubicación especificada y con el tamaño indicado.

Draw(Graphics, Point, Int32)

Dibuja la imagen indicada por el índice especificado, en el objeto Graphics indicado y en la ubicación dada.

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

Graphics donde se va a dibujar.

pt
Point

Ubicación definida por un objeto Point donde se va a dibujar la imagen.

index
Int32

Índice de la imagen en 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 las imágenes de la lista de imágenes.

Ejemplos

En el ejemplo de código siguiente se muestra cómo construir , ImageListagregar imágenes a la Images propiedad , establecer la ImageSize propiedad y usar 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

Se aplica a

Draw(Graphics, Int32, Int32, Int32)

Dibuja la imagen indicada por el índice especificado, en el objeto Graphics indicado y en la ubicación dada.

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

Graphics donde se va a dibujar.

x
Int32

Posición horizontal donde se va a dibujar la imagen.

y
Int32

Posición vertical donde se va a dibujar la imagen.

index
Int32

Índice de la imagen en 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 las imágenes de la lista de imágenes.

Se aplica a

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

Se dibuja la imagen indicada por el índice especificado en el objeto Graphics indicado, en la ubicación especificada y con el tamaño indicado.

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

Graphics donde se va a dibujar.

x
Int32

Posición horizontal donde se va a dibujar la imagen.

y
Int32

Posición vertical donde 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 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 las 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.

Se aplica a