TIcon - C++ Builder 参考手册

主页 → C++ Builder 资料 → C++ Builder 参考手册 → Pictures 图片 → TIcon

TIcon - ico 图标

说明：

TIcon: 处理 ico 图标

头文件：

#include <Vcl.Graphics.hpp> (XE2 之后)，#include <Graphics.hpp> (XE 之前)

继承关系：

TObject → TPersistent → TInterfacedPersistent → TGraphic → TIcon

属性：

属性	类型	描述
public:
Handle	HICON	图标的句柄，读写属性。如果没有加载图标，Handle 属性为 NULL。
TGraphic::		从 TGraphic 继承过来的
Empty	bool	是否包含图像数据，只读。如果不包含图像数据，此属性为 true.
Height	int	图像的高度，可读写，单位：像素 (pixels) 可以用 SetSize 方法同时修改宽度和高度
Modified	bool	图像是否被修改过。如果被修改过，此属性为 true.
Palette	HPALETTE	调色板句柄，可读写。如果图片没有或者不需要调色板，此值为 NULL
PaletteModified	bool	调色板是否被修改过，如果被修改过，此属性值为 true.
Transparent	bool	图像是否存在透明部分，可读写。
Width	int	图像的宽度，可读写，单位：像素 (pixels) 可以用 SetSize 方法同时修改宽度和高度
SupportsPartialTransparency	bool	是否支持半透明或 Alpha 通道，只读属性。

方法：

方法	描述
public:
TIcon	__fastcall virtual TIcon(void); 构造函数。
~TIcon	__fastcall virtual ~TIcon(void); 析构函数。
Assign	virtual void __fastcall Assign(System::Classes::TPersistent* Source); 把 Source 里面的图像赋值给当前图标。
AssignTo	virtual void __fastcall AssignTo(System::Classes::TPersistent* Dest); 把当前图片数据赋值给 Dest。
HandleAllocated	bool __fastcall HandleAllocated(void); 获取 Handle 属性是否分配了有效的 HICON 图标句柄。由于读取 Handle 属性的时候，如果 Handle 属性没有分配有效的 HICON 句柄，会自动创建一个，所以，如果想知道当前 Handle 属性是否真正分配了 HICON 句柄，就需要用 HandleAllocated 方法，因为 HandleAllocated 方法并不会创建图标句柄。
LoadFromClipboardFormat	virtual void __fastcall LoadFromClipboardFormat(System::Word AFormat, NativeUInt AData, HPALETTE APalette); 从剪贴板加载图像数据，AFormat 为剪贴板数据格式，例如 CF_BITMAP，AData 为图像数据，APalette 为调色板句柄。【请参考 TBitmap 的例子：从剪贴板加载位图】
LoadFromStream	virtual void __fastcall LoadFromStream(System::Classes::TStream* Stream); 从流加载图像。
ReleaseHandle	HICON __fastcall ReleaseHandle(void); 放弃使用 Handle 句柄，让句柄和 TIcon 脱离关系，把 Handle 属性置为 NULL，并且返回原先的 Handle 值。给 Handle 属性赋值的时候，先调用 ReleaseHandle 方法不会让原先句柄的数据丢失，那个句柄可以给别人使用和管理。
SaveToClipboardFormat	virtual void __fastcall SaveToClipboardFormat(System::Word &Format, NativeUInt &Data, HPALETTE &APalette); 把当前的图像数据转为剪贴板格式的数据，可以把这些数据放入剪贴板。【请参考 TBitmap 的例子：把位图放在剪贴板里面】
SaveToStream	virtual void __fastcall SaveToStream(System::Classes::TStream* Stream); 把图像数据保存到流。
SetSize	virtual void __fastcall SetSize(int AWidth, int AHeight); 修改图像的大小为：宽度 = AWidth，高度 = AHeight，单位为像素 (pixels)
LoadFromResourceName	void __fastcall LoadFromResourceName(NativeUInt Instance, const System::UnicodeString ResName); 通过名称从资源里面加载图标。Instance 为 exe 或 dll 文件的实例句柄，ResName 为位图资源的名称。
LoadFromResourceID	void __fastcall LoadFromResourceID(NativeUInt Instance, int ResID); 通过 ID 从资源里面加载图标。Instance 为 exe 或 dll 文件的实例句柄，ResID 为位图资源的 ID.
TGraphic::	从 TGraphic 继承过来的
Equals	virtual bool __fastcall Equals(System::TObject* Obj); 比较当前图像是否和 Obj 的图像数据相同。
LoadFromFile	virtual void __fastcall LoadFromFile(const System::UnicodeString Filename); 从文件加载图像。
SaveToFile	virtual void __fastcall SaveToFile(const System::UnicodeString Filename); 把当前图像储存为文件。
operator _di_IStreamPersist()	operator System::Classes::_di_IStreamPersist() { System::Classes::_di_IStreamPersist intf; this->GetInterface(intf); return intf; } 类型转换操作符，转为 _di_IStreamPersist 类型。
protected:
Draw	virtual void __fastcall Draw(TCanvas* ACanvas, const System::Types::TRect &Rect); 把当前图像数据显示到画布 ACanvas 的 Rect 位置。
GetEmpty	virtual bool __fastcall GetEmpty(void); 返回图像数据是否为空。
GetHeight	virtual int __fastcall GetHeight(void); 返回图像的高度，单位：像素 (pixels)。
GetWidth	virtual int __fastcall GetWidth(void); 返回图像的宽度，单位：像素 (pixels)。
SetHeight	virtual void __fastcall SetHeight(int Value); 把图像高度修改为 Value，单位：像素 (pixels)
SetTransparent	virtual void __fastcall SetTransparent(bool Value); 设为是否需要把图像显示为透明。
SetWidth	virtual void __fastcall SetWidth(int Value); 把图像宽度修改为 Value，单位：像素 (pixels)
TGraphic::	从 TGraphic 继承过来的
Changed	virtual void __fastcall Changed(System::TObject* Sender); 当图像数据被修改的时候，会自动调用 Changed 方法。 Changed 方法会把 Modified 属性置为 true，并且触发 OnChange 事件。
DefineProperties	virtual void __fastcall DefineProperties(System::Classes::TFiler* Filer); 重载 TPersistent 的 DefineProperties，用于 ReadData 和 WriteData 方法读写流图像数据。
DrawTransparent	virtual void __fastcall DrawTransparent(TCanvas* ACanvas, const System::Types::TRect &Rect, System::Byte Opacity); 把当前图像数据显示到画布 ACanvas 的 Rect 位置，和画布 Rect 位置原来的显示内容混合在一起，Opacity 为混合的比例，用来实现图像的透明效果，即 Opacity 为图像不透明的程度。
Equals	HIDESBASE virtual bool __fastcall Equals(TGraphic* Graphic)/* overload */; 比较当前图像是否和 Obj 的图像数据相同。
GetPalette	virtual HPALETTE __fastcall GetPalette(void); 返回调色板句柄。
GetTransparent	virtual bool __fastcall GetTransparent(void); 返回图像是否存在透明部分。
Progress	DYNAMIC void __fastcall Progress(System::TObject* Sender, TProgressStage Stage, System::Byte PercentDone, bool RedrawNow, const System::Types::TRect &R, const System::UnicodeString Msg); 当图像改变时 (加载、存储、转换的过程中)，会调用这个方法来触发 OnProgress 事件。
ReadData	virtual void __fastcall ReadData(System::Classes::TStream* Stream); 从 Stream 里面读取图像数据。
SetPalette	virtual void __fastcall SetPalette(HPALETTE Value); 调色板改为使用 Value 句柄的调色板。
WriteData	virtual void __fastcall WriteData(System::Classes::TStream* Stream); 把图像数据写到 Stream 里面
GetSupportsPartialTransparency	virtual bool __fastcall GetSupportsPartialTransparency(void); 返回是否支持半透明或 Alpha 通道。

事件：

事件	描述
public:
TGraphic::	从 TGraphic 继承过来的
OnChange	__property System::Classes::TNotifyEvent OnChange = {read=FOnChange, write=FOnChange}; • 当加载的图像发生变化时产生的事件，如果正在显示这个图片，需要刷新显示。 • 对于 gif 动画，需要显示下一帧的时候，会产生这个事件，需要在这个事件里面刷新显示【例：直接在画布上显示 gif 动画】
OnProgress	__property TProgressEvent OnProgress = {read=FOnProgress, write=FOnProgress}; 当加载、存储、转换的过程中，会产生这个事件，表示这个过程的进度。

◤上一页：TGraphic

下一页：TJPEGImage◢

C++ 爱好者 -- Victor Chen 的个人网站