BeginTilingPatternA
类别 向量图形、页面布局
说明
末尾的 A 表示 ANSI(char)DLL 入口点;ActiveX/COM 接口仅公开 Unicode 形式。其行为与 BeginTilingPattern 相同,字符串参数按当前 SetAnsiMode 代码页解释
使用请求的图案名称、宽度和高度启动临时平铺图案绘图表面
构建处于活动状态时,常规绘制调用会写入此函数选择的临时页面
使用 EndTilingPattern 完成构建以注册图案,或调用 CancelTilingPattern 丢弃临时绘图表面
语法
Delphi
Function DLBeginTilingPatternA(InstanceID: Integer; PatternName: PAnsiChar; Width, Height: Double): Integer;
DLL
int DLBeginTilingPatternA(int InstanceID, const char * PatternName, double Width, double Height);
参数
| PatternName | 随后供 SetFillTilingPattern、SetLineTilingPattern 或 SetTextTilingPattern 使用的名称 |
|---|---|
| Width | 图案单元格宽度,单位为 PDF 单位 |
| Height | PDF 单位下的图案单元格高度 |
返回值
| 0 | 名称或尺寸无效、可重用表面构建已处于活动状态、名称已存在或无法创建临时绘图表面 |
|---|---|
| 1 | 已创建并选中平铺图案绘制表面 |
备注
在构建结束或取消之前,不要选择其他页面或文档;绘制命令应以 BeginTilingPattern 选择的临时页面为目标
已注册的图案可通过 SetFillTilingPattern、SetLineTilingPattern 和 SetTextTilingPattern 跨页面复用
另请参阅
EndTilingPattern、CancelTilingPattern、SetFillTilingPattern、NewTilingPatternFromCapturedPage