Freigeben über

ImageList.ImageSize-Eigenschaft

  • Artikel

Ruft die Größe der Bilder in der Bildliste ab oder legt diese fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
<LocalizableAttribute(True)> _
Public Property ImageSize As Size
'Usage
Dim instance As ImageList
Dim value As Size

value = instance.ImageSize

instance.ImageSize = value

[LocalizableAttribute(true)] 
public Size ImageSize { get; set; }

[LocalizableAttribute(true)] 
public:
property Size ImageSize {
    Size get ();
    void set (Size value);
}

/** @property */
public Size get_ImageSize ()

/** @property */
public void set_ImageSize (Size value)

public function get ImageSize () : Size

public function set ImageSize (value : Size)

Eigenschaftenwert

Die Size, die die Höhe und Breite der Bilder in der Bildliste in Pixel festlegt. Die Standardgröße ist 16 x 16. Die maximale Größe ist 256 x 256.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentException

Der zugewiesene Wert ist gleich IsEmpty.

- oder -

Der Wert für die Höhe oder Breite ist kleiner als oder gleich 0.

- oder -

Der Wert für die Höhe oder Breite ist größer als 256.

ArgumentOutOfRangeException

Eine Abmessung der neuen Größe ist kleiner als 0 oder größer als 256.

Hinweise

Wenn Sie die ImageSize-Eigenschaft festlegen, bevor Sie der Auflistung von Bildern Bilder hinzufügen, wird die Größe der Bilder auf die angegebene Bildgröße geändert.

Beim Festlegen der ImageSize-Eigenschaft auf einen neuen Wert wird das Handle für die Bildliste neu erstellt.

Da das Handle beim Festlegen der ImageSize-Eigenschaft neu erstellt wird, müssen Sie die ImageSize vor der Images-Eigenschaft festlegen. Wenn Sie die ColorDepth-Eigenschaft oder die ImageSize-Eigenschaft nach dem Festlegen der Images-Eigenschaft im Code festlegen, wird die für die Images-Eigenschaft festgelegte Auflistung von Bildern gelöscht.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie eine ImageList konstruiert wird, Bilder zur Images-Eigenschaft hinzugefügt werden, die ImageSize-Eigenschaft festgelegt und die Draw-Methode verwendet wird. Fügen Sie das Beispiel zum Ausführen in ein Formular ein, das eine Schaltfläche mit dem Namen Button1 enthält. Im Beispiel wird davon ausgegangen, dass sich im Verzeichnis c:\Windows\ FeatherTexture.bmp und Gone Fishing.bmp befindet. Wenn die Bitmapdateien nicht im System vorhanden bzw. an einem anderen Ort gespeichert sind, ändern Sie das Beispiel entsprechend.

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

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);
    }
}

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 );

      }
   }

private System.Windows.Forms.ImageList imageList1;

// Create an ImageList Object, populate it, and display
// the images it contains.
private void button1_Click(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.set_ImageSize(new Size(112, 112));
    // Add two images to the list.
    imageList1.get_Images().Add(Image.FromFile(
        "c:\\windows\\FeatherTexture.bmp"));
    imageList1.get_Images().Add(Image.FromFile(
        "C:\\windows\\Gone Fishing.bmp"));
    // Get a Graphics object from the form's handle.
    Graphics theGraphics = Graphics.FromHwnd(this.get_Handle());
    // Loop through the images in the list, drawing each image.
    for (int count = 0; count < imageList1.get_Images().get_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);
    }
} //button1_Click

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

ImageList-Klasse
ImageList-Member
System.Windows.Forms-Namespace