ImageList.ImageSize プロパティ

.NET Framework クラス ライブラリ リファレンス

ImageList.ImageSize プロパティ

イメージ リスト内のイメージのサイズを取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

<LocalizableAttribute(True)> _
Public Property ImageSize As
 Size

Visual Basic (使用法)

Dim instance As ImageList
Dim value As Size

value = instance.ImageSize

instance.ImageSize = value

C#

[LocalizableAttribute(true)] 
public Size ImageSize { get; set;
 }

C++

[LocalizableAttribute(true)] 
public:
property Size ImageSize {
    Size get ();
    void set (Size value);
}

J#

/** @property */
public Size get_ImageSize ()

/** @property */
public void set_ImageSize (Size value)

JScript

public function get ImageSize
 () : Size

public function set ImageSize
 (value : Size)

プロパティ値
リスト内のイメージの高さと幅をピクセル単位で定義する Size。既定のサイズは 16 × 16 です。最大サイズは 256 × 256 です。

例外

例外の種類	条件
ArgumentException	代入された値が IsEmpty と同じです。 または 高さまたは幅の値が 0 以下です。 または 高さまたは幅の値が 256 を超えています。
ArgumentOutOfRangeException	新しいサイズが 0 未満か、256 を超えています。

解説

イメージ コレクションにイメージを追加する前に ImageSize プロパティを設定すると、イメージのサイズが指定したイメージ サイズに変更されます。

ImageSize プロパティを新しい値に設定すると、そのイメージ リストに対する Handle が再び作成されます。

ImageSize プロパティを設定するとハンドルが再作成されるため、Images プロパティを設定する前に ImageSize を設定する必要があります。コード内で Images プロパティを設定した後、ColorDepth プロパティまたは ImageSize プロパティを設定すると、Images プロパティに設定されているイメージ セットのコレクションが削除されます。

使用例

ImageList を構築し、Images プロパティにイメージを追加し、ImageSize プロパティを設定して、Draw メソッドを使用するコード例を次に示します。この例を実行するには、Button1 という名前のボタンが配置されたフォームの中にこの例を配置します。この例では、c:\Windows\ に FeatherTexture.bmp および Gone Fishing.bmp が置かれていることを前提としています。これらのビットマップがシステムに存在しない場合、または他の場所に存在する場合は、必要に応じて例を変更してください。

Visual Basic

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

C#

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);
    }
}

C++

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 );

      }
   }

J#

private System.Windows.Forms.ImageList imageList1;

// Create an ImageList Object, populate it, and display
// the images it contains.
private void button1_Click(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.set_ImageSize(new Size(112, 112));
    // Add two images to the list.
    imageList1.get_Images().Add(Image.FromFile(
        "c:\\windows\\FeatherTexture.bmp"));
    imageList1.get_Images().Add(Image.FromFile(
        "C:\\windows\\Gone Fishing.bmp"));
    // Get a Graphics object from the form's handle.
    Graphics theGraphics = Graphics.FromHwnd(this.get_Handle());
    // Loop through the images in the list, drawing each image.
    for (int count = 0; count < imageList1.get_Images().get_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);
    }
} //button1_Click

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
ImageList クラス
ImageList メンバ
System.Windows.Forms 名前空間