FigureElement
概述
FigureElement 是 Aspose.PDF FOSS 中用于 .NET 的类。继承自：IllustrationElement。
此类提供 15 个方法，用于在 .NET 程序中处理 FigureElement 对象。可用的方法包括：AdjustPosition, AppendChild, ChangeParentElement, ClearId, Detach, FindElements, RemoveAndMoveItsChildObjectsToItsParent, SetId, SetImage, SetTag, SetText, ToString。在安装 Aspose.PDF FOSS for .NET 包后，所有公共成员对任何 .NET 应用程序均可访问。属性：ActualText, AlternativeText, Attributes, ChildElements, ExpansionText, ID，以及另外 11 项。
属性
| 名称 | 类型 | 访问 | 描述 |
|---|---|---|---|
ImagePath | string? | 读取 | 为此插图提供的图像文件。 |
ImageWidth | double | 读取 | 图像宽度覆盖（0 = 自动）。 |
ImageHeight | double | 读取 | 图像高度覆盖 (0 = 自动)。 |
Resolution | int | 读取 | 图像分辨率 (DPI) 覆盖 (0 = 自动)。 |
StructureTextState | StructureTextState | 读取 | 文本状态已应用于此元素的内联内容（仅存储 — FOSS 结构构建器不会重新渲染）。 |
Attributes | StructureElementAttributes | 读取 | 附加到此元素的结构属性 (/A)，按所有者组织。 |
StructureType | string | 读取 | PDF 的结构类型角色 (/S 条目，例如. |
S | StructureType | 读取 | 元素的结构类型 (/S) 作为一个 StructureType，其 Name 为角色标签（例如. |
ActualText | string | 读写 | 标记内容的替换文本 (/ActualText)。 |
AlternativeText | string | 读写 | 辅助技术使用的替代文本 (/Alt)。 |
ExpansionText | string | 读写 | 缩写的展开文本 (/E)。 |
Language | string | 读写 | BCP-47 语言代码用于元素的内容 (/Lang)。 |
ID | string | 读取 | 元素标识符 (/ID)；只读 — 保存时分配。 |
Title | string | 读写 | 结构元素的标题 (/T)。 |
Page | Page? | 读取 | 承载此元素内容的页面，如果该元素尚未附加到页面，则为 null。 |
ParentElement | StructureElement? | 读取 | 父结构元素，如果该元素已分离或直接位于结构树根部，则为 null。 |
ChildElements | ElementList | 读取 | 此元素的直接子元素。 |
方法
| 签名 | 描述 |
|---|---|
SetImage(imagePath: string) | 将光栅/矢量图片绑定到此插图。 |
SetImage(imagePath: string, width: double, height: double) | 绑定具有明确尺寸的图片。 |
SetImage(imagePath: string, resolution: int) | 绑定具有明确分辨率（DPI）的图片。 |
AppendChild(child: StructureElement) | 在此元素的 /K 数组下追加子项。 |
SetTag(tag: string) | 将此元素的角色重新映射为自定义标签，在文档角色映射中注册标签 → 其标准类型。 |
ToString() | 在转储结构树时使用的文本表示（角色名称；如果没有则回退到类型名称）。 |
FindElements(recursive: bool) | 递归查找类型为 T 的后代元素。 |
AppendChild(child: StructureElement, validate: bool) | 追加子元素，可选地进行一次验证。 |
SetText(text: string) | 设置元素的文本内容（存储为 ActualText）。 |
SetId(id: string) | 设置元素标识符（/ID）。 |
ClearId() | 删除元素标识符 (/ID)。 |
AdjustPosition(settings: object) | 捕获为已编写结构元素请求的布局位置。 |
ChangeParentElement(newParent: StructureElement, validate: bool) | 将此元素移动到 newParent 下。 |
RemoveAndMoveItsChildObjectsToItsParent(validate: bool) | 将此元素分离，然后将其子元素重新挂靠到该元素原先的父元素下（占用该元素的槽位）。 |
Detach() | 将此元素从其父元素中分离。 |
