TGraphic - C++ Builder 参考手册

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

TGraphic - 图片类的公共父类，是一个纯虚类

说明：

TGraphic: 纯虚类，图片类的公共父类，
从 TGraphic 继承的类有：TBitmap, TGIFImage, TIcon, TJPEGImage, TMetafile, TPngImage, TWICImage 等。

头文件：

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

继承关系：

TObject → TPersistent → TInterfacedPersistent → TGraphic

属性：

属性	类型	描述
public:
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:
TGraphic	__fastcall virtual TGraphic(void); 构造函数
~TGraphic	__fastcall virtual ~TGraphic(void); 析构函数
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); 把当前图像储存为文件。
LoadFromStream	virtual void __fastcall LoadFromStream(System::Classes::TStream* Stream) = 0 ; 从流加载图像。
SaveToStream	virtual void __fastcall SaveToStream(System::Classes::TStream* Stream) = 0 ; 把图像数据保存到流。
LoadFromClipboardFormat	virtual void __fastcall LoadFromClipboardFormat(System::Word AFormat, NativeUInt AData, HPALETTE APalette) = 0 ; 从剪贴板加载图像数据，AFormat 为剪贴板数据格式，例如 CF_BITMAP，AData 为图像数据，APalette 为调色板句柄。【请参考 TBitmap 的例子：从剪贴板加载位图】
SaveToClipboardFormat	virtual void __fastcall SaveToClipboardFormat(System::Word &AFormat, NativeUInt &AData, HPALETTE &APalette) = 0 ; 把当前的图像数据转为剪贴板格式的数据，可以把这些数据放入剪贴板。【请参考 TBitmap 的例子：把位图放在剪贴板里面】
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:
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 方法读写流图像数据。
Draw	virtual void __fastcall Draw(TCanvas* ACanvas, const System::Types::TRect &Rect) = 0 ; 把当前图像数据显示到画布 ACanvas 的 Rect 位置。
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 的图像数据相同。
GetEmpty	virtual bool __fastcall GetEmpty(void) = 0 ; 返回图像数据是否为空。
GetHeight	virtual int __fastcall GetHeight(void) = 0 ; 返回图像的高度，单位：像素 (pixels)。
GetPalette	virtual HPALETTE __fastcall GetPalette(void); 返回调色板句柄。
GetTransparent	virtual bool __fastcall GetTransparent(void); 返回图像是否存在透明部分。
GetWidth	virtual int __fastcall GetWidth(void) = 0 ; 返回图像的宽度，单位：像素 (pixels)。
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 里面读取图像数据。
SetHeight	virtual void __fastcall SetHeight(int Value) = 0 ; 把图像高度修改为 Value，单位：像素 (pixels)
SetPalette	virtual void __fastcall SetPalette(HPALETTE Value); 调色板改为使用 Value 句柄的调色板。
SetTransparent	virtual void __fastcall SetTransparent(bool Value); 设为是否需要把图像显示为透明。
SetWidth	virtual void __fastcall SetWidth(int Value) = 0 ; 把图像宽度修改为 Value，单位：像素 (pixels)
WriteData	virtual void __fastcall WriteData(System::Classes::TStream* Stream); 把图像数据写到 Stream 里面
GetSupportsPartialTransparency	virtual bool __fastcall GetSupportsPartialTransparency(void); 返回是否支持半透明或 Alpha 通道。

事件：

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

◤上一页：TGIFImage

下一页：TIcon◢

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