Freigeben über

ImageList.Draw Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Zeichnet das angegebene Bild.

Überlädt

Draw(Graphics, Point, Int32)

Zeichnet das durch den angegebenen Index bestimmte Bild an der angegebenen Position in der festgelegten Graphics.
Draw(Graphics, Int32, Int32, Int32)

Zeichnet das durch den angegebenen Index bestimmte Bild an der angegebenen Position in der festgelegten Graphics.
Draw(Graphics, Int32, Int32, Int32, Int32, Int32)

Zeichnet das durch den angegebenen Index festgelegte Bild im angegebenen Graphics an der angegebenen Position und in der angegebenen Größe.

Draw(Graphics, Point, Int32)

Zeichnet das durch den angegebenen Index bestimmte Bild an der angegebenen Position in der festgelegten 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)

Parameter

g
Graphics

Die Instanz von Graphics, in der gezeichnet werden soll.

pt
Point

Die von einem Point definierte Position, an der das Bild gezeichnet werden soll.

index
Int32

Der Index des zu zeichnenden Bildes in der ImageList.

Ausnahmen

ArgumentOutOfRangeException

Der Wert ist kleiner als 0.

- oder -

Der Index ist größer oder gleich der Anzahl der Bilder in der Bildliste.

Beispiele

Das folgende Codebeispiel veranschaulicht das Erstellen eines ImageList, das Images Hinzufügen von Bildern zur -Eigenschaft, das Festlegen der ImageSize -Eigenschaft und die Verwendung der Draw -Methode. Um dieses Beispiel auszuführen, platzieren Sie es in einem Formular, das eine Schaltfläche mit dem Namen enthält Button1. Im Beispiel wird davon ausgegangen, dass und Gone Fishing.bmp unter c:\Windows\ vorhanden FeatherTexture.bmp ist. Ändern Sie das Beispiel entsprechend, wenn die Bitmaps nicht auf Ihrem System vorhanden sind oder an einer anderen Stelle vorhanden sind.

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

Gilt für:

Draw(Graphics, Int32, Int32, Int32)

Zeichnet das durch den angegebenen Index bestimmte Bild an der angegebenen Position in der festgelegten 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)

Parameter

g
Graphics

Die Instanz von Graphics, in der gezeichnet werden soll.

x
Int32

Die horizontale Position, an der das Bild gezeichnet werden soll.

y
Int32

Die vertikale Position, an der das Bild gezeichnet werden soll.

index
Int32

Der Index des zu zeichnenden Bildes in der ImageList.

Ausnahmen

ArgumentOutOfRangeException

Der Wert ist kleiner als 0.

- oder -

Der Index ist größer oder gleich der Anzahl der Bilder in der Bildliste.

Gilt für:

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

Zeichnet das durch den angegebenen Index festgelegte Bild im angegebenen Graphics an der angegebenen Position und in der angegebenen Größe.

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)

Parameter

g
Graphics

Die Instanz von Graphics, in der gezeichnet werden soll.

x
Int32

Die horizontale Position, an der das Bild gezeichnet werden soll.

y
Int32

Die vertikale Position, an der das Bild gezeichnet werden soll.

width
Int32

Die Breite des Zielbildes in Pixel.

height
Int32

Die Höhe des Zielbildes in Pixel.

index
Int32

Der Index des zu zeichnenden Bildes in der ImageList.

Ausnahmen

ArgumentOutOfRangeException

Der Wert ist kleiner als 0.

- oder -

Der Index ist größer oder gleich der Anzahl der Bilder in der Bildliste.

Hinweise

Das Bild wird nach Bedarf gestreckt oder komprimiert, um den bereitgestellten Grenzen zu entsprechen.

Gilt für: