ImageList.ImageSize Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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

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

Eigenschaftswert

Size

Die Size, die die Höhe und Breite der Bilder in der Bildliste in Pixel festlegt. Die Standardgröße beträgt 16 mal 16. Die maximale Größe beträgt 256 mal 256.

Ausnahmen

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.

Beispiele

Im folgenden Codebeispiel wird das Erstellen eines ImageList, das Hinzufügen von Bildern zur Eigenschaft, das Festlegen der Images ImageSize Eigenschaft und die Verwendung der Draw Methode veranschaulicht. Wenn Sie dieses Beispiel ausführen möchten, platzieren Sie es in einem Formular, das eine Schaltfläche mit dem Namen " Button1. Im Beispiel wird davon ausgegangen, dass c:\Windows\ vorhanden FeatherTexture.bmp ist.Gone Fishing.bmp Ändern Sie das Beispiel entsprechend, wenn die Bitmaps nicht auf Ihrem System vorhanden sind oder an einem anderen Speicherort vorhanden sind.

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

Hinweise

Wenn Sie die ImageSize Eigenschaft vor dem Hinzufügen von Bildern zur Bildsammlung festlegen, wird die Größe der Bilder auf die angegebene Bildgröße geändert.

Wenn Sie die ImageSize Eigenschaft auf einen neuen Wert festlegen, wird die Handle Bildliste neu erstellt.

Da das Festlegen der ImageSize Eigenschaft bewirkt, dass das Handle neu erstellt wird, sollten Sie vor dem Festlegen der Images Eigenschaft festlegenImageSize. Wenn das Handle für das ImageList Objekt erstellt wurde, wird das Festlegen der ColorDepth Eigenschaften im ImageSize Code nach dem Festlegen der Images Eigenschaft dazu führen, dass die Sammlung von Bildern, die für die Images Eigenschaft festgelegt sind, gelöscht wird.