ImageList.ImageSize Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera lub ustawia rozmiar obrazów na liście obrazów.

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

Wartość właściwości

Size

Element Size definiujący wysokość i szerokość obrazów na liście w pikselach. Domyślny rozmiar to 16 do 16. Maksymalny rozmiar to 256 do 256.

Wyjątki

ArgumentException

Przypisana wartość jest równa IsEmpty.

-lub- Wartość wysokości lub szerokości jest mniejsza lub równa 0.

-lub- Wartość wysokości lub szerokości jest większa niż 256.

ArgumentOutOfRangeException

Nowy rozmiar ma wymiar mniejszy niż 0 lub większy niż 256.

Przykłady

Poniższy przykład kodu przedstawia konstruowanie ImageList, dodawanie obrazów do Images właściwości, ustawianie ImageSize właściwości i używanie Draw metody . Aby uruchomić ten przykład, umieść go w formularzu zawierającym przycisk o nazwie Button1. W przykładzie przyjęto założenie istnienia FeatherTexture.bmp obiektu i Gone Fishing.bmp w lokalizacji c:\Windows\. Zmień przykład odpowiednio, jeśli mapy bitowe nie istnieją w systemie lub istnieją w innej lokalizacji.

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

Uwagi

ImageSize Ustawienie właściwości przed dodaniem obrazów do kolekcji obrazów powoduje zmianę rozmiaru obrazów na określony rozmiar obrazu.

Po ustawieniu ImageSize właściwości na nową wartość Handle zostanie ponownie utworzona lista obrazów.

Ponieważ ustawienie ImageSize właściwości powoduje ponowne utworzenie uchwytu, należy ustawić ImageSize przed ustawieniem Images właściwości . Po utworzeniu ColorDepth uchwytu ImageList dla właściwości lub ImageSize w kodzie po ustawieniu Images właściwości spowoduje usunięcie kolekcji obrazów ustawionych dla Images właściwości.