ImageList.ImageSize Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Sumber:

ImageList.cs

Mendapatkan atau mengatur ukuran gambar dalam daftar gambar.

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

Nilai Properti

Size

Size yang menentukan tinggi dan lebar, dalam piksel, gambar dalam daftar. Ukuran defaultnya adalah 16 kali 16. Ukuran maksimum adalah 256 kali 256.

Pengecualian

ArgumentException

Nilai yang ditetapkan sama dengan IsEmpty.

-atau-

Nilai tinggi atau lebar kurang dari atau sama dengan 0.

-atau-

Nilai tinggi atau lebar lebih besar dari 256.

ArgumentOutOfRangeException

Ukuran baru memiliki dimensi kurang dari 0 atau lebih besar dari 256.

Contoh

Contoh kode berikut menunjukkan pembuatan ImageList, menambahkan gambar ke Images properti, mengatur ImageSize properti, dan menggunakan Draw metode . Untuk menjalankan contoh ini, letakkan dalam formulir yang berisi tombol bernama Button1. Contoh mengasumsikan keberadaan FeatherTexture.bmp dan Gone Fishing.bmp di c:\Windows\. Ubah contoh yang sesuai jika bitmap tidak ada di sistem Anda, atau ada di lokasi lain.

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

Keterangan

ImageSize Mengatur properti sebelum menambahkan gambar ke koleksi gambar menyebabkan gambar diubah ukurannya menjadi ukuran gambar yang ditentukan.

Saat Anda mengatur ImageSize properti ke nilai baru, Handle untuk daftar gambar dibuat ulang.

Karena mengatur ImageSize properti menyebabkan handel dibuat ulang, Anda harus mengatur ImageSize sebelum mengatur Images properti. Ketika handel untuk ImageList telah dibuat, mengatur ColorDepth properti atau ImageSize dalam kode, setelah mengatur Images properti, akan menyebabkan kumpulan gambar yang diatur untuk Images properti dihapus.