ImageList.ImageCollection.Add Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Ajoute l’objet spécifié à ImageList.
Surcharges
Add(Icon) |
Ajoute l'icône spécifiée à ImageList. |
Add(Image) |
Ajoute l'image spécifiée à ImageList. |
Add(Image, Color) |
Ajoute l'image spécifiée à ImageList, en utilisant la couleur spécifiée pour générer le masque. |
Add(String, Icon) |
Ajoute une icône avec la clé spécifiée à la fin de la collection. |
Add(String, Image) |
Ajoute une image avec la clé spécifiée à la fin de la collection. |
Add(Icon)
Ajoute l'icône spécifiée à ImageList.
public:
void Add(System::Drawing::Icon ^ value);
public void Add (System.Drawing.Icon value);
member this.Add : System.Drawing.Icon -> unit
Public Sub Add (value As Icon)
Paramètres
Exceptions
Exemples
L’exemple de code suivant illustre la construction d’une , l’ajout d’images ImageListà la Images propriété, la définition de la ImageSize propriété et l’utilisation de la Draw méthode. Pour exécuter cet exemple, placez-le dans un formulaire qui contient un bouton nommé Button1
. L’exemple suppose l’existence de FeatherTexture.bmp et gone Fishing.bmp à c:\Windows\. Modifiez l’exemple en conséquence si les bitmaps n’existent pas sur votre système ou existent à un autre emplacement.
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
Remarques
La Icon valeur est convertie en une Bitmap valeur avant d’être ajoutée à la liste.
S’applique à
Add(Image)
Ajoute l'image spécifiée à ImageList.
public:
void Add(System::Drawing::Image ^ value);
public void Add (System.Drawing.Image value);
member this.Add : System.Drawing.Image -> unit
Public Sub Add (value As Image)
Paramètres
Exceptions
L'image ajoutée est null
.
L'image ajoutée n'est pas Bitmap.
S’applique à
Add(Image, Color)
Ajoute l'image spécifiée à ImageList, en utilisant la couleur spécifiée pour générer le masque.
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 -> int
Public Function Add (value As Image, transparentColor As Color) As Integer
Paramètres
Retours
Index de la nouvelle image ajoutée ou -1 si l'image n'a pas pu être ajoutée.
Exceptions
L'image ajoutée est null
.
L'image ajoutée n'est pas Bitmap.
S’applique à
Add(String, Icon)
Ajoute une icône avec la clé spécifiée à la fin de la collection.
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 -> unit
Public Sub Add (key As String, icon As Icon)
Paramètres
- key
- String
Nom de l'icône.
Exceptions
icon
a la valeur null
.
Remarques
Le nom d’une image correspond à sa clé dans le ImageList.ImageCollection. Une clé d’image ne respecte pas la casse.
S’applique à
Add(String, Image)
Ajoute une image avec la clé spécifiée à la fin de la collection.
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 -> unit
Public Sub Add (key As String, image As Image)
Paramètres
- key
- String
Nom de l'image.
Exceptions
image
a la valeur null
.
Remarques
Le nom d’une image correspond à sa clé dans le ImageList.ImageCollection. Une clé d’image ne respecte pas la casse.