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 单位 |
| Height | PDF 单位下的图案单元格高度 |
返回值
| 0 | 名称或尺寸无效、可重用表面构建已处于活动状态、名称已存在或无法创建临时绘图表面 |
|---|---|
| 1 | 已创建并选中平铺图案绘制表面 |
备注
在构建结束或取消之前,不要选择其他页面或文档;绘制命令应以 BeginTilingPattern 选择的临时页面为目标
已注册的图案可通过 SetFillTilingPattern、SetLineTilingPattern 和 SetTextTilingPattern 跨页面复用
另请参阅
EndTilingPattern、CancelTilingPattern、SetFillTilingPattern、NewTilingPatternFromCapturedPage