ImageList::Draw Method (Graphics^, Point, Int32)
Draws the image indicated by the specified index on the specified Graphics at the given location.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Parameters
- g
-
Type:
System.Drawing::Graphics^
The Graphics to draw on.
- pt
-
Type:
System.Drawing::Point
The location defined by a Point at which to draw the image.
- index
-
Type:
System::Int32
The index of the image in the ImageList to draw.
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | The index is less than 0. -or- The index is greater than or equal to the count of images in the image list. |
The following code example demonstrates constructing an ImageList, adding images to the Images property, setting the ImageSize property, and using the Draw method. To run this example, place it in a form containing a button named Button1. The example assumes the existence of FeatherTexture.bmp and Gone Fishing.bmp at c:\Windows\. 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 ); } }
Available since 1.1