ImageList.Draw ImageList.Draw ImageList.Draw ImageList.Draw Method

Definición

Dibuja la imagen indicada.Draws the indicated image.

Sobrecargas

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

Dibuja la imagen indicada por el índice especificado, en el objeto Graphics indicado y en la ubicación dada.Draws the image indicated by the specified index on the specified Graphics at the given location.

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

Dibuja la imagen indicada por el índice especificado, en el objeto Graphics indicado y en la ubicación dada.Draws the image indicated by the given index on the specified Graphics at the specified location.

Draw(Graphics, Int32, Int32, Int32, Int32, Int32) Draw(Graphics, Int32, Int32, Int32, Int32, Int32) Draw(Graphics, Int32, Int32, Int32, Int32, Int32) 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.Draws the image indicated by the given index on the specified Graphics using the specified location and size.

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

Dibuja la imagen indicada por el índice especificado, en el objeto Graphics indicado y en la ubicación dada.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)

Parámetros

g
Graphics Graphics Graphics Graphics

Graphics donde se va a dibujar.The Graphics to draw on.

pt
Point Point Point Point

Ubicación definida por un objeto Point donde se va a dibujar la imagen.The location defined by a Point at which to draw the image.

index
Int32 Int32 Int32 Int32

Índice de la imagen en ImageList que se va a dibujar.The index of the image in the ImageList to draw.

Excepciones

El índice es menor que 0.The index is less than 0.

O bien-or-

El índice es mayor o igual que el recuento de las imágenes de la lista de imágenes.The index is greater than or equal to the count of images in the image list.

Ejemplos

En el ejemplo de código siguiente se muestra ImageListcómo construir, agregar imágenes Images a la propiedad, ImageSize establecer la propiedad y utilizar Draw el método.The following code example demonstrates constructing an ImageList, adding images to the Images property, setting the ImageSize property, and using the Draw method. Para ejecutar este ejemplo, colóquelo en un formulario que contenga un botón Button1denominado.To run this example, place it in a form containing a button named Button1. En el ejemplo se supone que FeatherTexture.bmp existe Gone Fishing.bmp y en\c:\Windows.The example assumes the existence of FeatherTexture.bmp and Gone Fishing.bmp at c:\Windows\. Cambie el ejemplo en consecuencia si los mapas de bits no existen en el sistema o no existen en otra ubicación.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) Draw(Graphics, Int32, Int32, Int32) Draw(Graphics, Int32, Int32, Int32) Draw(Graphics, Int32, Int32, Int32)

Dibuja la imagen indicada por el índice especificado, en el objeto Graphics indicado y en la ubicación dada.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)

Parámetros

g
Graphics Graphics Graphics Graphics

Graphics donde se va a dibujar.The Graphics to draw on.

x
Int32 Int32 Int32 Int32

Posición horizontal donde se va a dibujar la imagen.The horizontal position at which to draw the image.

y
Int32 Int32 Int32 Int32

Posición vertical donde se va a dibujar la imagen.The vertical position at which to draw the image.

index
Int32 Int32 Int32 Int32

Índice de la imagen en ImageList que se va a dibujar.The index of the image in the ImageList to draw.

Excepciones

El índice es menor que 0.The index is less than 0.

O bien-or-

El índice es mayor o igual que el recuento de las imágenes de la lista de imágenes.The index is greater than or equal to the count of images in the image list.

Draw(Graphics, Int32, Int32, Int32, Int32, Int32) Draw(Graphics, Int32, Int32, Int32, Int32, Int32) Draw(Graphics, Int32, Int32, Int32, Int32, Int32) 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.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)

Parámetros

g
Graphics Graphics Graphics Graphics

Graphics donde se va a dibujar.The Graphics to draw on.

x
Int32 Int32 Int32 Int32

Posición horizontal donde se va a dibujar la imagen.The horizontal position at which to draw the image.

y
Int32 Int32 Int32 Int32

Posición vertical donde se va a dibujar la imagen.The vertical position at which to draw the image.

width
Int32 Int32 Int32 Int32

Ancho, en píxeles, de la imagen de destino.The width, in pixels, of the destination image.

height
Int32 Int32 Int32 Int32

Alto, en píxeles, de la imagen de destino.The height, in pixels, of the destination image.

index
Int32 Int32 Int32 Int32

Índice de la imagen en ImageList que se va a dibujar.The index of the image in the ImageList to draw.

Excepciones

El índice es menor que 0.The index is less than 0.

O bien-or-

El índice es mayor o igual que el recuento de las imágenes de la lista de imágenes.The index is greater than or equal to the count of images in the image list.

Comentarios

La imagen se ajusta o se comprime según sea necesario para ajustarse a los límites proporcionados.The image is stretched or compressed as necessary to fit the bounds provided.

Se aplica a