ImageList.ImageCollection.Add Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee voegt u het opgegeven object toe aan de ImageList.
Overloads
| Name | Description |
|---|---|
| Add(Icon) |
Hiermee voegt u het opgegeven pictogram toe aan de ImageList. |
| Add(Image) |
Voegt de opgegeven afbeelding toe aan de ImageList. |
| Add(Image, Color) |
Hiermee voegt u de opgegeven afbeelding toe aan de ImageListopgegeven kleur om het masker te genereren. |
| Add(String, Icon) |
Hiermee voegt u een pictogram met de opgegeven sleutel toe aan het einde van de verzameling. |
| Add(String, Image) |
Voegt een afbeelding met de opgegeven sleutel toe aan het einde van de verzameling. |
Add(Icon)
Hiermee voegt u het opgegeven pictogram toe aan de ImageList.
public:
void Add(System::Drawing::Icon ^ value);public void Add(System.Drawing.Icon value);member this.Add : System.Drawing.Icon -> unitPublic Sub Add (value As Icon)Parameters
Uitzonderingen
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u een ImageListafbeelding bouwt, afbeeldingen toevoegt aan de Images eigenschap, de ImageSize eigenschap instelt en de Draw methode gebruikt. Als u dit voorbeeld wilt uitvoeren, plaatst u het in een formulier met een knop met de naam Button1. In het voorbeeld wordt ervan uitgegaan dat er FeatherTexture.bmp en Gone Fishing.bmp zijn op c:\Windows\. Wijzig het voorbeeld dienovereenkomstig als de bitmaps niet op uw systeem bestaan of op een andere locatie bestaan.
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
Opmerkingen
De Icon wordt geconverteerd naar een Bitmap voordat deze wordt toegevoegd aan de lijst.
Van toepassing op
Add(Image)
Voegt de opgegeven afbeelding toe aan de ImageList.
public:
void Add(System::Drawing::Image ^ value);public void Add(System.Drawing.Image value);member this.Add : System.Drawing.Image -> unitPublic Sub Add (value As Image)Parameters
Uitzonderingen
De afbeelding die wordt toegevoegd, is null.
De afbeelding die wordt toegevoegd, is geen Bitmap.
Van toepassing op
Add(Image, Color)
Hiermee voegt u de opgegeven afbeelding toe aan de ImageListopgegeven kleur om het masker te genereren.
public:
int Add(System::Drawing::Image ^ value, System::Drawing::Color transparentColor);public int Add(System.Drawing.Image value, System.Drawing.Color transparentColor);member this.Add : System.Drawing.Image * System.Drawing.Color -> intPublic Function Add (value As Image, transparentColor As Color) As IntegerParameters
Retouren
De index van de zojuist toegevoegde installatiekopieën of -1 als de afbeelding niet kan worden toegevoegd.
Uitzonderingen
De afbeelding die wordt toegevoegd, is null.
De afbeelding die wordt toegevoegd, is geen Bitmap.
Van toepassing op
Add(String, Icon)
Hiermee voegt u een pictogram met de opgegeven sleutel toe aan het einde van de verzameling.
public:
void Add(System::String ^ key, System::Drawing::Icon ^ icon);public void Add(string key, System.Drawing.Icon icon);member this.Add : string * System.Drawing.Icon -> unitPublic Sub Add (key As String, icon As Icon)Parameters
- key
- String
De naam van het pictogram.
Uitzonderingen
icon is null.
Opmerkingen
De naam van een afbeelding komt overeen met de sleutel in de ImageList.ImageCollectionafbeelding. Een afbeeldingssleutel is niet hoofdlettergevoelig.
Van toepassing op
Add(String, Image)
Voegt een afbeelding met de opgegeven sleutel toe aan het einde van de verzameling.
public:
void Add(System::String ^ key, System::Drawing::Image ^ image);public void Add(string key, System.Drawing.Image image);member this.Add : string * System.Drawing.Image -> unitPublic Sub Add (key As String, image As Image)Parameters
- key
- String
De naam van de afbeelding.
Uitzonderingen
image is null.
Opmerkingen
De naam van een afbeelding komt overeen met de sleutel in de ImageList.ImageCollectionafbeelding. Een afbeeldingssleutel is niet hoofdlettergevoelig.
