ButtonBase.ImageList 属性

获取或设置包含按钮控件上显示的 Image 的 ImageList。

**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms（在 system.windows.forms.dll 中）

语法

声明
Public Property ImageList As ImageList
用法
Dim instance As ButtonBase
Dim value As ImageList

value = instance.ImageList

instance.ImageList = value

public ImageList ImageList { get; set; }

public:
property ImageList^ ImageList {
    ImageList^ get ();
    void set (ImageList^ value);
}

/** @property */
public ImageList get_ImageList ()

/** @property */
public void set_ImageList (ImageList value)

public function get ImageList () : ImageList

public function set ImageList (value : ImageList)

属性值

一个 ImageList。默认值为 空引用（在 Visual Basic 中为 Nothing）。

备注

设置 ImageList 或 ImageIndex 属性后，Image 属性将被设置为 空引用（在 Visual Basic 中为 Nothing），这是其默认值。

提示

如果 ImageList 属性值改为 空引用（在 Visual Basic 中为 Nothing），则 ImageIndex 属性返回它的默认值 -1。但是，将在内部保留已分配的 ImageIndex 值并在将另一个 ImageList 分配给 ImageList 属性时使用该值。如果分配给 ImageList 属性的新 ImageList 所具有的 ImageList.ImageCollection.Count 属性值小于或等于分配给 ImageIndex 属性的值减 1（由于集合的索引从零开始所致），则 ImageIndex 属性值将调整为比 Count 属性值小 1。例如，假设有一个按钮控件，它的 ImageList 有三个图像，并且它的 ImageIndex 属性设置为 2。如果分配给该按钮的新 ImageList 仅有两个图像，则 ImageIndex 值改为 1。

示例

下面的代码示例使用派生类 Button，并设置 ImageList 和 ImageIndex 属性。这段代码要求已创建了一个 ImageList，并至少为它分配了一个 Image。这段代码还要求有一个存储在 C:\Graphics 目录中的名为 MyBitMap.bmp 的位图图像。

Private Sub AddMyImage()
    ' Assign an image to the ImageList.
    ImageList1.Images.Add(Image.FromFile("C:\Graphics\MyBitmap.bmp"))
    ' Assign the ImageList to the button control.   
    button1.ImageList = ImageList1
    ' Select the image from the ImageList (using the ImageIndex property).    
    button1.ImageIndex = 0
End Sub 'AddMyImage

private void AddMyImage()
 {
    // Assign an image to the ImageList.
    ImageList1.Images.Add(Image.FromFile("C:\\Graphics\\MyBitmap.bmp"));
    // Assign the ImageList to the button control.   
    button1.ImageList = ImageList1;
    // Select the image from the ImageList (using the ImageIndex property).    
    button1.ImageIndex = 0;
 }
 

private:
   void AddMyImage()
   {
      // Assign an image to the imageList.
      imageList1->Images->Add( Image::FromFile( "C:\\Graphics\\MyBitmap.bmp" ) );
      // Assign the imageList to the button control.
      button1->ImageList = imageList1;
      // Select the image from the ImageList (using the ImageIndex property).
      button1->ImageIndex = 0;
   }

private void AddMyImage()
{
    // Assign an image to the ImageList.
    imageList1.get_Images().Add(Image.FromFile(
        "C:\\Graphics\\MyBitmap.bmp"));
    // Assign the ImageList to the button control.   
    button1.set_ImageList(imageList1);
    // Select the image from the ImageList (using the ImageIndex property).    
    button1.set_ImageIndex(0);
} //AddMyImage

private function AddMyImage()
 {
    // Assign an image to the ImageList.
    ImageList1 = new ImageList;
    ImageList1.Images.Add(Image.FromFile("C:\\Graphics\\MyBitmap.bmp"));
    // Assign the ImageList to the button control.   
    button1.ImageList = ImageList1;
    // Select the image from the ImageList (using the ImageIndex property).    
    button1.ImageIndex = 0;
 }
 

平台

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

请参见

参考

ButtonBase 类
ButtonBase 成员
System.Windows.Forms 命名空间
Image
ButtonBase.ImageIndex 属性