ImageList.ColorDepth 属性

获取图像列表的颜色深度。

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

语法

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

value = instance.ColorDepth

instance.ColorDepth = value
public ColorDepth ColorDepth { get; set; }
public:
property ColorDepth ColorDepth {
    ColorDepth get ();
    void set (ColorDepth value);
}
/** @property */
public ColorDepth get_ColorDepth ()

/** @property */
public void set_ColorDepth (ColorDepth value)
public function get ColorDepth () : ColorDepth

public function set ColorDepth (value : ColorDepth)

属性值

图像的可用颜色数。在 .NET Framework 1.0 版本中,默认值为 Depth4Bit。在 .NET Framework 1.1 或更高版本中,默认值为 Depth8Bit

异常

异常类型 条件

InvalidEnumArgumentException

颜色深度不是有效的 ColorDepth 枚举值。

备注

当将颜色深度设置为新值时,将重新创建图像列表的 Handle

因为设置 ColorDepth 属性会导致重新创建句柄,所以应在设置 Images 属性之前设置 ColorDepth。如果在设置 Images 属性之后,在代码中设置 ColorDepthImageSize 属性,将会导致删除为 Images 属性设置的图像集合。

平台

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

请参见

参考

ImageList 类
ImageList 成员
System.Windows.Forms 命名空间
ColorDepth 枚举