此类用作图形对象的管理器。它将所有图形对象存储在图形列表中， 并使用POSITION对象来枚举它们。有效的POSITION对象可用于获取一个图形对象， 插入新的图形对象甚至删除一个。
如果任何图形对象被更改，或者图形对象被插入/删除，应该调用函数 fsdk.GraphicsObjects.GenerateContent 以确保所有这些更改都存储 到PDF文档中。更多详情请参考函数 fsdk.GraphicsObjects.GenerateContent 。
PDF页面的内容通常由一系列图形对象组成，这意味着PDF页面也像图形对象的管理器一样使用。 因此类 fsdk.PDFPage 派生自类 GraphicsObjects ，以便 类 PDFPage 可以检索其图形对象。
表单XObject是一种图形对象，它是任何图形对象序列的自包含描述， 所以函数 fsdk.FormXObject.GetGraphicsObjects 可以用来从表单XObject中检索GraphicsObjects对象， 以便管理包含在表单XObject中的图形对象。
- 参见
- PDFPage
-
fsdk.FormXObject
-
fsdk.GraphicsObject
◆ GenerateContent() [1/2]
| def fsdk.GraphicsObjects.GenerateContent |
( |
|
a, |
|
|
|
interface |
|
) |
| |
生成当前图形对象的内容。
如果任何图形对象发生更改，或者图形对象被插入/移除/移动，应该 在保存相关PDF文档之前调用此函数，以确保所有这些更改都会存储到 PDF文档中。由于生成内容可能需要很长时间，不建议用户 频繁调用此函数，而应该只在必要时调用此函数，例如， 在即将保存相关PDF文档之前。
当此函数成功时，如果当前图形对象代表PDF页面，建议用户 通过函数fsdk.PDFPage.StartParse 重新解析PDF页面，参数is_reparse为true， 然后再对页面内容执行某些操作；否则操作的结果可能是意外的。 例如，如果在此函数成功后没有重新解析PDF页面就渲染PDF页面，页面内容 可能无法按预期渲染或可能发生意外错误。 请参考函数fsdk.PDFPage.StartParse 了解有关重新解析PDF页面的更多详细信息。
- 返回
- true表示成功，false表示失败。
◆ GenerateContent() [2/2]
| def fsdk.GraphicsObjects.GenerateContent |
( |
|
text_merge_option | ) |
|
生成当前图形对象的内容。
如果任何图形对象发生更改，或者图形对象被插入/移除/移动，应该 在保存相关PDF文档之前调用此函数，以确保所有这些更改都会存储到 PDF文档中。由于生成内容可能需要很长时间，不建议用户 频繁调用此函数，而应该只在必要时调用此函数，例如， 在即将保存相关PDF文档之前。
当此函数成功时，如果当前图形对象代表PDF页面，建议用户 通过函数fsdk.PDFPage.StartParse 重新解析PDF页面，参数is_reparse为true， 然后再对页面内容执行某些操作；否则操作的结果可能是意外的。 例如，如果在此函数成功后没有重新解析PDF页面就渲染PDF页面，页面内容 可能无法按预期渲染或可能发生意外错误。 请参考函数fsdk.PDFPage.StartParse 了解有关重新解析PDF页面的更多详细信息。
- 参数
-
- 返回
- true表示成功，false表示失败。
◆ GetFirstGraphicsObjectPosition()
| def fsdk.GraphicsObjects.GetFirstGraphicsObjectPosition |
( |
|
filter | ) |
|
◆ GetGraphicsObject() [1/2]
| def fsdk.GraphicsObjects.GetGraphicsObject |
( |
|
position | ) |
|
通过图形对象列表中的位置获取图形对象。
- 参数
-
| [in] | position | 表示图形对象列表中位置的POSITION对象。 不应为 null 或 0。 |
- 返回
- 一个 fsdk.GraphicsObject 对象。如果有任何错误，此函数将返回 null。
◆ GetGraphicsObject() [2/2]
| def fsdk.GraphicsObjects.GetGraphicsObject |
( |
|
index | ) |
|
通过索引获取图形对象。
- 参数
-
- 返回
- 图形对象。如果有任何错误，此函数将返回null。
◆ GetGraphicsObjectCount()
| def fsdk.GraphicsObjects.GetGraphicsObjectCount |
( |
| ) |
|
获取图形对象列表中图形对象的数量。
- 返回
- 图形对象列表中图形对象的数量。
◆ GetGraphicsObjectIndex()
| def fsdk.GraphicsObjects.GetGraphicsObjectIndex |
( |
|
graphics_object | ) |
|
获取指定图形对象在图形对象列表中的索引。
- 参数
-
| [in] | graphics_object | 要检索索引的图形对象。请确保 输入的图形对象属于当前图形对象。 |
- 返回
- 指定图形对象在图形对象列表中的索引。 -1表示参数graphics_object不属于当前图形对象列表。
◆ GetGraphicsObjectPosition()
| def fsdk.GraphicsObjects.GetGraphicsObjectPosition |
( |
|
graphics_object | ) |
|
获取指定图形对象的位置。
- 参数
-
| [in] | graphics_object | 要获取位置的图形对象。 |
- 返回
- 指定图形对象的位置。null 表示输入的图形对象不属于当前图形对象。
◆ GetLastGraphicsObjectPosition()
| def fsdk.GraphicsObjects.GetLastGraphicsObjectPosition |
( |
|
filter | ) |
|
◆ GetNextGraphicsObjectPosition()
| def fsdk.GraphicsObjects.GetNextGraphicsObjectPosition |
( |
|
position, |
|
|
|
filter |
|
) |
| |
◆ GetPrevGraphicsObjectPosition()
| def fsdk.GraphicsObjects.GetPrevGraphicsObjectPosition |
( |
|
position, |
|
|
|
filter |
|
) |
| |
◆ InsertGraphicsObject()
| def fsdk.GraphicsObjects.InsertGraphicsObject |
( |
|
position_insert_after, |
|
|
|
graphics_object |
|
) |
| |
◆ IsEmpty()
| def fsdk.GraphicsObjects.IsEmpty |
( |
| ) |
|
检查当前对象是否为空。
当前对象为空时，意味着当前对象无用。
- 返回
- true 表示当前对象为空，false 表示不为空。
◆ MoveGraphicsObjectByPosition()
| def fsdk.GraphicsObjects.MoveGraphicsObjectByPosition |
( |
|
current_position, |
|
|
|
position_move_after |
|
) |
| |
◆ RemoveGraphicsObject()
| def fsdk.GraphicsObjects.RemoveGraphicsObject |
( |
|
graphics_object | ) |
|
◆ RemoveGraphicsObjectByPosition()
| def fsdk.GraphicsObjects.RemoveGraphicsObjectByPosition |
( |
|
position | ) |
|
