Description
内容
[
隐藏
]BuildingBlock.Description property
获取或设置与此构建块关联的描述。
public string Description { get; set; }
评论
描述可以包含任何字符串内容,通常是附加信息。
不可能是无效的
,但可以是空字符串。
对应于docPartPr.描述 OOXML 中的元素。
例子
演示如何将自定义构建块添加到文档中。
public void CreateAndInsert()
{
// 文档的术语表文档存储构建块。
Document doc = new Document();
GlossaryDocument glossaryDoc = new GlossaryDocument();
doc.GlossaryDocument = glossaryDoc;
// 创建一个构建块,为其命名,然后将其添加到术语表文档中。
BuildingBlock block = new BuildingBlock(glossaryDoc)
{
Name = "Custom Block"
};
glossaryDoc.AppendChild(block);
// 默认情况下,所有新的构建块 GUID 都具有相同的零值,我们可以给它们一个新的唯一值。
Assert.AreEqual("00000000-0000-0000-0000-000000000000", block.Guid.ToString());
block.Guid = Guid.NewGuid();
// 以下属性对构建块进行分类
// 在菜单中我们可以通过“插入”在 Microsoft Word 中访问 -> “快速零件”-> “积木组织者”。
Assert.AreEqual("(Empty Category)", block.Category);
Assert.AreEqual(BuildingBlockType.None, block.Type);
Assert.AreEqual(BuildingBlockGallery.All, block.Gallery);
Assert.AreEqual(BuildingBlockBehavior.Content, block.Behavior);
// 在我们将此构建块添加到文档之前,我们需要为其提供一些内容,
// 我们将使用文档访问者来完成此操作。该访客还将设置类别、画廊和行为。
BuildingBlockVisitor visitor = new BuildingBlockVisitor(glossaryDoc);
block.Accept(visitor);
// 我们可以访问刚刚从词汇表文档中创建的块。
BuildingBlock customBlock = glossaryDoc.GetBuildingBlock(BuildingBlockGallery.QuickParts,
"My custom building blocks", "Custom Block");
// 块本身是包含文本的部分。
Assert.AreEqual($"Text inside {customBlock.Name}\f", customBlock.FirstSection.Body.FirstParagraph.GetText());
Assert.AreEqual(customBlock.FirstSection, customBlock.LastSection);
// 现在,我们可以将其作为新部分插入到文档中。
doc.AppendChild(doc.ImportNode(customBlock.FirstSection, true));
// 我们也可以在 Microsoft Word 的 Building Blocks Organizer 中找到它并手动放置。
doc.Save(ArtifactsDir + "BuildingBlocks.CreateAndInsert.dotx");
}
/// <summary>
/// 设置要作为快速部分插入到文档中的已访问构建块,并向其内容添加文本。
/// </summary>
public class BuildingBlockVisitor : DocumentVisitor
{
public BuildingBlockVisitor(GlossaryDocument ownerGlossaryDoc)
{
mBuilder = new StringBuilder();
mGlossaryDoc = ownerGlossaryDoc;
}
public override VisitorAction VisitBuildingBlockStart(BuildingBlock block)
{
// 将 Building Block 配置为快速部件,并添加 Building Blocks Organizer 使用的属性。
block.Behavior = BuildingBlockBehavior.Paragraph;
block.Category = "My custom building blocks";
block.Description =
"Using this block in the Quick Parts section of word will place its contents at the cursor.";
block.Gallery = BuildingBlockGallery.QuickParts;
// 添加带有文本的部分。
// 将块插入到文档中将在该位置附加此部分及其子节点。
Section section = new Section(mGlossaryDoc);
block.AppendChild(section);
block.FirstSection.EnsureMinimum();
Run run = new Run(mGlossaryDoc, "Text inside " + block.Name);
block.FirstSection.Body.FirstParagraph.AppendChild(run);
return VisitorAction.Continue;
}
public override VisitorAction VisitBuildingBlockEnd(BuildingBlock block)
{
mBuilder.Append("Visited " + block.Name + "\r\n");
return VisitorAction.Continue;
}
private readonly StringBuilder mBuilder;
private readonly GlossaryDocument mGlossaryDoc;
}
也可以看看
- class BuildingBlock
- 命名空间 Aspose.Words.BuildingBlocks
- 部件 Aspose.Words