ImageList.ImageSize Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

ImageList.cs

Görüntü listesindeki görüntülerin boyutunu alır veya ayarlar.

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

Özellik Değeri

Size

Size Listedeki görüntülerin yüksekliğini ve genişliğini piksel cinsinden tanımlayan. Varsayılan boyut 16'ya 16'dır. Maksimum boyut 256 ile 256'dır.

Özel durumlar

ArgumentException

Atanan değer değerine IsEmptyeşittir.

-veya-

Yükseklik veya genişlik değeri 0'dan küçük veya buna eşittir.

-veya-

Yükseklik veya genişlik değeri 256'dan büyük.

ArgumentOutOfRangeException

Yeni boyutun boyutu 0'dan küçük veya 256'dan büyük.

Örnekler

Aşağıdaki kod örneğinde ImageList, özelliğine Images görüntü ekleme, özelliği ayarlama ImageSize ve yöntemini kullanma işlemleri gösterilmektedir Draw . Bu örneği çalıştırmak için, adlı Button1düğmeyi içeren bir forma yerleştirin. Örnekte, ve değerinin FeatherTexture.bmpGone Fishing.bmp c:\Windows\ konumunda olduğu varsayılır. Bit eşlemler sisteminizde yoksa veya başka bir konumda mevcutsa örneği buna göre değiştirin.

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

Açıklamalar

Görüntü koleksiyonuna ImageSize görüntü eklemeden önce özelliğinin ayarlanması, görüntülerin belirtilen görüntü boyutuna göre yeniden boyutlandırılmasına neden olur.

özelliğini yeni bir değere ayarladığınızda ImageSizeHandle , görüntü listesi için yeniden oluşturulur.

özelliğinin ImageSize ayarlanması tanıtıcının yeniden oluşturulmasına neden olduğundan, özelliği ayarlamadan önce ayarlamanız ImageSizeImages gerekir. için tanıtıcı ImageList oluşturulduğunda, özelliğini ayarladıktan sonra kodda veya ImageSize özelliklerini ayarlamak ColorDepthImages özelliği için ayarlanan görüntü koleksiyonunun Images silinmesine neden olur.