BeginTilingPattern

类别 向量图形、页面布局

说明

使用请求的图案名称、宽度和高度启动临时平铺图案绘图表面

构建处于活动状态时,常规绘制调用会写入此函数选择的临时页面

使用 EndTilingPattern 完成构建以注册图案,或调用 CancelTilingPattern 丢弃临时绘图表面

语法

Delphi

Function TPDFlib.BeginTilingPattern(Const PatternName: WideString; Width, Height: Double): Integer;

ActiveX

Function PDFlib::BeginTilingPattern(PatternName As String, Width As Double, Height As Double) As Long

DLL

int DLBeginTilingPattern(int InstanceID, const wchar_t * PatternName, double Width, double Height);

参数

PatternName随后供 SetFillTilingPattern、SetLineTilingPattern 或 SetTextTilingPattern 使用的名称
Width图案单元格宽度,单位为 PDF 单位
HeightPDF 单位下的图案单元格高度

返回值

0名称或尺寸无效、可重用表面构建已处于活动状态、名称已存在或无法创建临时绘图表面
1已创建并选中平铺图案绘制表面

备注

在构建结束或取消之前,不要选择其他页面或文档;绘制命令应以 BeginTilingPattern 选择的临时页面为目标

已注册的图案可通过 SetFillTilingPattern、SetLineTilingPattern 和 SetTextTilingPattern 跨页面复用

另请参阅

EndTilingPattern、CancelTilingPattern、SetFillTilingPattern、NewTilingPatternFromCapturedPage