ImageList.ImageSize 屬性

定義

取得或設定影像清單中的影像大小。Gets or sets the size of the images in the image list.

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

屬性值

Size,定義清單中的影像高度和寬度 (以像素為單位)。The Size that defines the height and width, in pixels, of the images in the list. 預設大小是 16 x 16。The default size is 16 by 16. 最大大小是 256 x 256。The maximum size is 256 by 256.

例外狀況

指派的值等於 IsEmptyThe value assigned is equal to IsEmpty.

-或--or- 高度或寬度的值小於或等於 0。The value of the height or width is less than or equal to 0.

-或--or- 高度或寬度的值大於 256。The value of the height or width is greater than 256.

新的大小具有小於 0 或大於 256 的維度 (Dimension)。The new size has a dimension less than 0 or greater than 256.

範例

下列程式碼範例示範如何建立ImageList、將影像加入Images至屬性、設定ImageSize屬性, 以及使用Draw方法。The following code example demonstrates constructing an ImageList, adding images to the Images property, setting the ImageSize property, and using the Draw method. 若要執行此範例, 請將它放在包含名為Button1之按鈕的表單中。To run this example, place it in a form containing a button named Button1. 此範例假設在 c:\Windows FeatherTexture.bmp \中存在Gone Fishing.bmp和。The example assumes the existence of FeatherTexture.bmp and Gone Fishing.bmp at c:\Windows\. 如果點陣圖不存在於您的系統上, 或存在於另一個位置, 請據以變更範例。Change the example accordingly if the bitmaps do not exist on your system, or exist at another location.

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

備註

在將影像新增至影像集合之前設定屬性,會將影像大小調整為指定的影像大小。ImageSizeSetting the ImageSize property prior to adding images to the image collection causes the images to be resized to the image size specified.

當您將ImageSize屬性設定為新的值時, Handle會重新建立影像清單的。When you set the ImageSize property to a new value, the Handle for the image list is recreated.

由於設定ImageSize屬性會導致重新建立控制碼, 因此您應該在ImageSize設定Images屬性之前設定。Because setting the ImageSize property causes the handle to be recreated, you should set ImageSize prior to setting the Images property. 建立的ImageList控制碼之後, 在程式碼中ColorDepth設定或ImageSize屬性, 在設定Images Images屬性之後, 將會導致已設定要刪除之屬性的影像集合。When the handle for the ImageList has been created, setting the ColorDepth or ImageSize properties in code, after setting the Images property, will cause the collection of images set for the Images property to be deleted.

適用於