ImageList.ImageSize 属性
获取或设置图像列表中的图像大小。
**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms（在 system.windows.forms.dll 中）
语法
声明
<LocalizableAttribute(True)> _
Public Property ImageSize As Size
用法
Dim instance As ImageList
Dim value As Size
value = instance.ImageSize
instance.ImageSize = value
[LocalizableAttribute(true)]
public Size ImageSize { get; set; }
[LocalizableAttribute(true)]
public:
property Size ImageSize {
Size get ();
void set (Size value);
}
/** @property */
public Size get_ImageSize ()
/** @property */
public void set_ImageSize (Size value)
public function get ImageSize () : Size
public function set ImageSize (value : Size)
属性值
定义列表中的图像高度和宽度（以像素为单位）的 Size。默认大小是 16 X 16。最大大小是 256 X 256。
异常
| 异常类型 | 条件 |
|---|---|
所分配的值等于 IsEmpty。 - 或 - 高度或宽度值小于或等于零。 - 或 - 高度或宽度值大于 256。 |
|
新大小有一个维度小于 0 或大于 256。 |
备注
在将图像添加到图像集合之前设置 ImageSize 属性，会导致将图像调整到指定的图像大小。
当将 ImageSize 属性设置为新值时，将重新创建图像列表的 Handle。
因为设置 ImageSize 属性会导致重新创建句柄，所以应在设置 Images 属性之前设置 ImageSize。如果在设置 Images 属性之后，在代码中设置 ColorDepth 或 ImageSize 属性，将会导致删除为 Images 属性设置的图像集合。
示例
下面的代码示例演示如何构造 ImageList、如何向 Images 属性添加图像、如何设置 ImageSize 属性以及如何使用 Draw 方法。若要运行此示例，请将它放到一个包含名为 Button1 的按钮的窗体中。该示例假定 c:\Windows\ 中存在 FeatherTexture.bmp 和 Gone Fishing.bmp。如果您的系统中不存在这些位图，或者它们存在于其他位置，请对示例进行相应的更改。
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
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);
}
}
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 );
}
}
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