ImageList.ImageSize Eigenschap
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 wordt de grootte van de afbeeldingen in de lijst met afbeeldingen opgehaald of ingesteld.
public:
property System::Drawing::Size ImageSize { System::Drawing::Size get(); void set(System::Drawing::Size value); };
public System.Drawing.Size ImageSize { get; set; }
member this.ImageSize : System.Drawing.Size with get, set
Public Property ImageSize As Size
Waarde van eigenschap
Hiermee Size definieert u de hoogte en breedte, in pixels, van de afbeeldingen in de lijst. De standaardgrootte is 16 bij 16. De maximale grootte is 256 bij 256.
Uitzonderingen
De toegewezen waarde is gelijk aan IsEmpty.
– of –
De waarde van de hoogte of breedte is kleiner dan of gelijk aan 0.
– of –
De waarde van de hoogte of breedte is groter dan 256.
De nieuwe grootte heeft een dimensie kleiner dan 0 of groter dan 256.
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 om 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
Als u de ImageSize eigenschap instelt voordat u afbeeldingen toevoegt aan de verzameling afbeeldingen, wordt het formaat van de afbeeldingen gewijzigd in de opgegeven afbeeldingsgrootte.
Wanneer u de ImageSize eigenschap instelt op een nieuwe waarde, wordt de Handle lijst met afbeeldingen opnieuw gemaakt.
Omdat het instellen van de ImageSize eigenschap ervoor zorgt dat de ingang opnieuw wordt gemaakt, moet u instellen ImageSize voordat u de Images eigenschap instelt. Wanneer de ingang voor de ImageList eigenschap is gemaakt, zorgt het instellen van de ColorDepth of ImageSize eigenschappen in code Images ervoor dat de verzameling installatiekopieën die voor de Images eigenschap zijn ingesteld, wordt verwijderd.