TWICImage - C++ Builder 参考手册

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

TWICImage - 使用 WIC API 处理图片，支持 bmp, jpg, png, gif, tif 等图片

说明：

TWICImage: 使用 WIC (Windows Imaging Component) API 处理图片，支持 bmp, jpg, png, gif, tif 等图片，
TImage 控件通常用这个来显示 .tif (tiff) 图片

头文件：

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

继承关系：

TObject → TPersistent → TInterfacedPersistent → TGraphic → TWICImage

属性：

属性	类型	描述
public:
Handle	_di_IWICBitmap	提供访问 IWicBitmap 的接口，可读写属性。利用这个 Handle 属性可以调用需要 IWicBitmap 的 Windows API 函数。
ImageFormat	TWICImageFormat	图像格式，可读写属性，可用的值： wifBmp: bmp 位图 wifPng: png 图像 wifJpeg: jpg 图像 wifGif: gif 图像 wifTiff: tif 图像 wifWMPhoto: Windows Media Photo 图像 wifOther: 位置的图像类型
EncoderContainerFormat	GUID	图像格式的 GUID 值，可读写属性，用来做为参数值提供给需要 GUID 的 Windows API 函数。
ImagingFactory	_di_IWICImagingFactory	提供 IWICImagingFactory 接口，只读属性。这个接口可以用来生成 IWicBitmap 接口。
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:
TWICImage	__fastcall virtual TWICImage(void); 构造函数
~TWICImage	__fastcall virtual ~TWICImage(void); 析构函数
Assign	virtual void __fastcall Assign(System::Classes::TPersistent* Source); 把 Source 的图像数据赋值 (格式转换) 到当前图像。
LoadFromStream	virtual void __fastcall LoadFromStream(System::Classes::TStream* Stream); 从流加载图像。
SaveToStream	virtual void __fastcall SaveToStream(System::Classes::TStream* Stream); 把图像数据保存到流。
LoadFromClipboardFormat	virtual void __fastcall LoadFromClipboardFormat(System::Word AFormat, NativeUInt AData, HPALETTE APalette); 从剪贴板加载图像数据，AFormat 为剪贴板数据格式，例如 CF_BITMAP，AData 为图像数据，APalette 为调色板句柄。【请参考 TBitmap 的例子：从剪贴板加载位图】
SaveToClipboardFormat	virtual void __fastcall SaveToClipboardFormat(System::Word &AFormat, NativeUInt &AData, HPALETTE &APalette); 把当前的图像数据转为剪贴板格式的数据，可以把这些数据放入剪贴板。【请参考 TBitmap 的例子：把位图放在剪贴板里面】
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); 把当前图像储存为文件。
SetSize	virtual void __fastcall SetSize(int AWidth, int AHeight); 修改图像的大小为：宽度 = AWidth，高度 = AHeight，单位为像素 (pixels)
operator _di_IStreamPersist()	operator System::Classes::_di_IStreamPersist() { System::Classes::_di_IStreamPersist intf; this->GetInterface(intf); return intf; } 类型转换操作符，转为 _di_IStreamPersist 类型。
protected:
AssignTo	virtual void __fastcall AssignTo(System::Classes::TPersistent* Dest); 把当前图像数据赋值 (格式转换) 到 Dest 的图像数据
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)
SetWidth	virtual void __fastcall SetWidth(int Value); 把图像宽度修改为 Value，单位：像素 (pixels)
RequireBitmap	void __fastcall RequireBitmap(void); 初始化内部使用的 TBitmap 位图，这个方法由 TWICImage 内部使用。
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 句柄的调色板。
SetTransparent	virtual void __fastcall SetTransparent(bool 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}; 当加载、存储、转换的过程中，会产生这个事件，表示这个过程的进度。

◤上一页：TPngImage

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