ImageList.ImageSize ImageList.ImageSize ImageList.ImageSize ImageList.ImageSize Property

定義

イメージ リスト内のイメージのサイズを取得または設定します。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

プロパティ値

リスト内のイメージの高さと幅をピクセル単位で定義する SizeThe Size that defines the height and width, in pixels, of the images in the list. 既定のサイズは 16 × 16 です。The default size is 16 by 16. 最大サイズは 256 × 256 です。The maximum size is 256 by 256.

例外

代入された値が IsEmpty と同じです。The 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 を超えています。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. この例では、とFeatherTexture.bmp Gone Fishing.bmpが c:\Windows\に存在することを前提としています。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

注釈

イメージコレクションImageSizeにイメージを追加する前にプロパティを設定すると、指定したイメージサイズに合わせて画像のサイズが変更されます。Setting 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プロパティを設定するとハンドルが再作成されるため、 ImagesプロパティImageSizeを設定する前にを設定する必要があります。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プロパティを設定した後に、コード内のプロパティまたはプロパティを設定すると、プロパティに設定されているイメージのコレクションが削除されます。ImagesWhen 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.

適用対象