设置结构元素属性

为了在标记 PDF 文档中设置结构元素属性，Aspose.PDF 提供了 CreateSectElement 和 CreateHeaderElement 方法，属于 ITaggedContent 接口。

以下代码片段展示了如何设置标记 PDF 文档的结构元素属性：

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void SetProperties()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Create PDF Document
    using (var document = new Aspose.Pdf.Document())
    {
        // Get Content for work with Tagged PDF
        Aspose.Pdf.Tagged.ITaggedContent taggedContent = document.TaggedContent;

        // Set Title and Language for Document
        taggedContent.SetTitle("Tagged Pdf Document");
        taggedContent.SetLanguage("en-US");

        // Create Structure Elements
        Aspose.Pdf.LogicalStructure.StructureElement rootElement = taggedContent.RootElement;

        Aspose.Pdf.LogicalStructure.SectElement sect = taggedContent.CreateSectElement();
        rootElement.AppendChild(sect);

        Aspose.Pdf.LogicalStructure.HeaderElement h1 = taggedContent.CreateHeaderElement(1);
        sect.AppendChild(h1);
        h1.SetText("The Header");

        h1.Title = "Title";
        h1.Language = "en-US";
        h1.AlternativeText = "Alternative Text";
        h1.ExpansionText = "Expansion Text";
        h1.ActualText = "Actual Text";

        // Save Tagged PDF Document
        document.Save(dataDir + "StructureElementsProperties_out.pdf");
    }
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void SetProperties()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Create PDF Document
    using var document = new Aspose.Pdf.Document();

    // Get Content for work with Tagged PDF
    Aspose.Pdf.Tagged.ITaggedContent taggedContent = document.TaggedContent;

    // Set Title and Language for Document
    taggedContent.SetTitle("Tagged Pdf Document");
    taggedContent.SetLanguage("en-US");

    // Create Structure Elements
    Aspose.Pdf.LogicalStructure.StructureElement rootElement = taggedContent.RootElement;

    Aspose.Pdf.LogicalStructure.SectElement sect = taggedContent.CreateSectElement();
    rootElement.AppendChild(sect);

    Aspose.Pdf.LogicalStructure.HeaderElement h1 = taggedContent.CreateHeaderElement(1);
    sect.AppendChild(h1);
    h1.SetText("The Header");

    h1.Title = "Title";
    h1.Language = "en-US";
    h1.AlternativeText = "Alternative Text";
    h1.ExpansionText = "Expansion Text";
    h1.ActualText = "Actual Text";

    // Save Tagged PDF Document
    document.Save(dataDir + "StructureElementsProperties_out.pdf");
}

设置文本结构元素

为了设置标记 PDF 文档的文本结构元素，Aspose.PDF 提供了 ParagraphElement 类。以下代码片段展示了如何设置标记 PDF 文档的文本结构元素：

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void SetTextElements()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Create PDF Document
    using (var document = new Aspose.Pdf.Document())
    {
        // Get Content for work with Tagged PDF
        Aspose.Pdf.Tagged.ITaggedContent taggedContent = document.TaggedContent;

        // Set Title and Language for Document
        taggedContent.SetTitle("Tagged Pdf Document");
        taggedContent.SetLanguage("en-US");

        // Get Root Structure Elements
        Aspose.Pdf.LogicalStructure.StructureElement rootElement = taggedContent.RootElement;

        Aspose.Pdf.LogicalStructure.ParagraphElement p = taggedContent.CreateParagraphElement();

        // Set Text to Text Structure Element
        p.SetText("Paragraph.");
        rootElement.AppendChild(p);

        // Save Tagged PDF Document
        document.Save(dataDir + "TextStructureElement_out.pdf");
    }
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void SetTextElements()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Create PDF Document
    using var document = new Aspose.Pdf.Document();

    // Get Content for work with TaggedPdf
    Aspose.Pdf.Tagged.ITaggedContent taggedContent = document.TaggedContent;

    // Set Title and Language for Document
    taggedContent.SetTitle("Tagged Pdf Document");
    taggedContent.SetLanguage("en-US");

    // Get Root Structure Elements
    Aspose.Pdf.LogicalStructure.StructureElement rootElement = taggedContent.RootElement;

    Aspose.Pdf.LogicalStructure.ParagraphElement p = taggedContent.CreateParagraphElement();

    // Set Text to Text Structure Element
    p.SetText("Paragraph.");
    rootElement.AppendChild(p);

    // Save Tagged PDF Document
    document.Save(dataDir + "TextStructureElement_out.pdf");
}

设置文本块结构元素

为了设置标记 PDF 文档的文本块结构元素，Aspose.PDF 提供了 HeaderElement 和 ParagraphElement 类。您可以将这些类的对象作为 StructureElement 对象的子项附加。 以下代码片段展示了如何设置标记 PDF 文档的文本块结构元素：

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void SetTextBlockElements()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Create PDF Document
    using (var document = new Aspose.Pdf.Document())
    {
        // Get Content for work with Tagged PDF
        Aspose.Pdf.Tagged.ITaggedContent taggedContent = document.TaggedContent;

        // Set Title and Language for Document
        taggedContent.SetTitle("Tagged Pdf Document");
        taggedContent.SetLanguage("en-US");

        // Get Root Structure Element
        Aspose.Pdf.LogicalStructure.StructureElement rootElement = taggedContent.RootElement;

        Aspose.Pdf.LogicalStructure.HeaderElement h1 = taggedContent.CreateHeaderElement(1);
        Aspose.Pdf.LogicalStructure.HeaderElement h2 = taggedContent.CreateHeaderElement(2);
        Aspose.Pdf.LogicalStructure.HeaderElement h3 = taggedContent.CreateHeaderElement(3);
        Aspose.Pdf.LogicalStructure.HeaderElement h4 = taggedContent.CreateHeaderElement(4);
        Aspose.Pdf.LogicalStructure.HeaderElement h5 = taggedContent.CreateHeaderElement(5);
        Aspose.Pdf.LogicalStructure.HeaderElement h6 = taggedContent.CreateHeaderElement(6);
        h1.SetText("H1. Header of Level 1");
        h2.SetText("H2. Header of Level 2");
        h3.SetText("H3. Header of Level 3");
        h4.SetText("H4. Header of Level 4");
        h5.SetText("H5. Header of Level 5");
        h6.SetText("H6. Header of Level 6");
        rootElement.AppendChild(h1);
        rootElement.AppendChild(h2);
        rootElement.AppendChild(h3);
        rootElement.AppendChild(h4);
        rootElement.AppendChild(h5);
        rootElement.AppendChild(h6);

        Aspose.Pdf.LogicalStructure.ParagraphElement p = taggedContent.CreateParagraphElement();
        p.SetText("P. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aenean nec lectus ac sem faucibus imperdiet. Sed ut erat ac magna ullamcorper hendrerit. Cras pellentesque libero semper, gravida magna sed, luctus leo. Fusce lectus odio, laoreet nec ullamcorper ut, molestie eu elit. Interdum et malesuada fames ac ante ipsum primis in faucibus. Aliquam lacinia sit amet elit ac consectetur. Donec cursus condimentum ligula, vitae volutpat sem tristique eget. Nulla in consectetur massa. Vestibulum vitae lobortis ante. Nulla ullamcorper pellentesque justo rhoncus accumsan. Mauris ornare eu odio non lacinia. Aliquam massa leo, rhoncus ac iaculis eget, tempus et magna. Sed non consectetur elit. Sed vulputate, quam sed lacinia luctus, ipsum nibh fringilla purus, vitae posuere risus odio id massa. Cras sed venenatis lacus.");
        rootElement.AppendChild(p);

        // Save Tagged PDF Document
        document.Save(dataDir + "TextBlockStructureElements_out.pdf");
    }
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void SetTextBlockElements()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Create PDF Document
    using var document = new Aspose.Pdf.Document();

    // Get Content for work with Tagged PDF
    Aspose.Pdf.Tagged.ITaggedContent taggedContent = document.TaggedContent;

    // Set Title and Language for Document
    taggedContent.SetTitle("Tagged Pdf Document");
    taggedContent.SetLanguage("en-US");

    // Get Root Structure Element
    Aspose.Pdf.LogicalStructure.StructureElement rootElement = taggedContent.RootElement;

    Aspose.Pdf.LogicalStructure.HeaderElement h1 = taggedContent.CreateHeaderElement(1);
    Aspose.Pdf.LogicalStructure.HeaderElement h2 = taggedContent.CreateHeaderElement(2);
    Aspose.Pdf.LogicalStructure.HeaderElement h3 = taggedContent.CreateHeaderElement(3);
    Aspose.Pdf.LogicalStructure.HeaderElement h4 = taggedContent.CreateHeaderElement(4);
    Aspose.Pdf.LogicalStructure.HeaderElement h5 = taggedContent.CreateHeaderElement(5);
    Aspose.Pdf.LogicalStructure.HeaderElement h6 = taggedContent.CreateHeaderElement(6);
    h1.SetText("H1. Header of Level 1");
    h2.SetText("H2. Header of Level 2");
    h3.SetText("H3. Header of Level 3");
    h4.SetText("H4. Header of Level 4");
    h5.SetText("H5. Header of Level 5");
    h6.SetText("H6. Header of Level 6");
    rootElement.AppendChild(h1);
    rootElement.AppendChild(h2);
    rootElement.AppendChild(h3);
    rootElement.AppendChild(h4);
    rootElement.AppendChild(h5);
    rootElement.AppendChild(h6);

    Aspose.Pdf.LogicalStructure.ParagraphElement p = taggedContent.CreateParagraphElement();
    p.SetText("P. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aenean nec lectus ac sem faucibus imperdiet. Sed ut erat ac magna ullamcorper hendrerit. Cras pellentesque libero semper, gravida magna sed, luctus leo. Fusce lectus odio, laoreet nec ullamcorper ut, molestie eu elit. Interdum et malesuada fames ac ante ipsum primis in faucibus. Aliquam lacinia sit amet elit ac consectetur. Donec cursus condimentum ligula, vitae volutpat sem tristique eget. Nulla in consectetur massa. Vestibulum vitae lobortis ante. Nulla ullamcorper pellentesque justo rhoncus accumsan. Mauris ornare eu odio non lacinia. Aliquam massa leo, rhoncus ac iaculis eget, tempus et magna. Sed non consectetur elit. Sed vulputate, quam sed lacinia luctus, ipsum nibh fringilla purus, vitae posuere risus odio id massa. Cras sed venenatis lacus.");
    rootElement.AppendChild(p);

    // Save Tagged PDF Document
    document.Save(dataDir + "TextBlockStructureElements_out.pdf");
}

设置行内结构元素

为了设置标记 PDF 文档的行内结构元素，Aspose.PDF 提供了 SpanElement 和 ParagraphElement 类。您可以将这些类的对象作为 StructureElement 对象的子项附加。以下代码片段展示了如何设置标记 PDF 文档的行内结构元素：

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void SetInlineElements()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Create PDF Document
    using (var document = new Aspose.Pdf.Document())
    {
        // Get Content for work with Tagged PDF
        Aspose.Pdf.Tagged.ITaggedContent taggedContent = document.TaggedContent;

        // Set Title and Language for Document
        taggedContent.SetTitle("Tagged Pdf Document");
        taggedContent.SetLanguage("en-US");

        // Get Root Structure Element
        Aspose.Pdf.LogicalStructure.StructureElement rootElement = taggedContent.RootElement;

        Aspose.Pdf.LogicalStructure.HeaderElement h1 = taggedContent.CreateHeaderElement(1);
        Aspose.Pdf.LogicalStructure.HeaderElement h2 = taggedContent.CreateHeaderElement(2);
        Aspose.Pdf.LogicalStructure.HeaderElement h3 = taggedContent.CreateHeaderElement(3);
        Aspose.Pdf.LogicalStructure.HeaderElement h4 = taggedContent.CreateHeaderElement(4);
        Aspose.Pdf.LogicalStructure.HeaderElement h5 = taggedContent.CreateHeaderElement(5);
        Aspose.Pdf.LogicalStructure.HeaderElement h6 = taggedContent.CreateHeaderElement(6);
        rootElement.AppendChild(h1);
        rootElement.AppendChild(h2);
        rootElement.AppendChild(h3);
        rootElement.AppendChild(h4);
        rootElement.AppendChild(h5);
        rootElement.AppendChild(h6);

        Aspose.Pdf.LogicalStructure.SpanElement spanH11 = taggedContent.CreateSpanElement();
        spanH11.SetText("H1. ");
        h1.AppendChild(spanH11);
        Aspose.Pdf.LogicalStructure.SpanElement spanH12 = taggedContent.CreateSpanElement();
        spanH12.SetText("Level 1 Header");
        h1.AppendChild(spanH12);

        Aspose.Pdf.LogicalStructure.SpanElement spanH21 = taggedContent.CreateSpanElement();
        spanH21.SetText("H2. ");
        h2.AppendChild(spanH21);
        Aspose.Pdf.LogicalStructure.SpanElement spanH22 = taggedContent.CreateSpanElement();
        spanH22.SetText("Level 2 Header");
        h2.AppendChild(spanH22);

        Aspose.Pdf.LogicalStructure.SpanElement spanH31 = taggedContent.CreateSpanElement();
        spanH31.SetText("H3. ");
        h3.AppendChild(spanH31);
        Aspose.Pdf.LogicalStructure.SpanElement spanH32 = taggedContent.CreateSpanElement();
        spanH32.SetText("Level 3 Header");
        h3.AppendChild(spanH32);

        Aspose.Pdf.LogicalStructure.SpanElement spanH41 = taggedContent.CreateSpanElement();
        spanH41.SetText("H4. ");
        h4.AppendChild(spanH41);
        Aspose.Pdf.LogicalStructure.SpanElement spanH42 = taggedContent.CreateSpanElement();
        spanH42.SetText("Level 4 Header");
        h4.AppendChild(spanH42);

        Aspose.Pdf.LogicalStructure.SpanElement spanH51 = taggedContent.CreateSpanElement();
        spanH51.SetText("H5. ");
        h5.AppendChild(spanH51);
        Aspose.Pdf.LogicalStructure.SpanElement spanH52 = taggedContent.CreateSpanElement();
        spanH52.SetText("Level 5 Header");
        h5.AppendChild(spanH52);

        Aspose.Pdf.LogicalStructure.SpanElement spanH61 = taggedContent.CreateSpanElement();
        spanH61.SetText("H6. ");
        h6.AppendChild(spanH61);
        Aspose.Pdf.LogicalStructure.SpanElement spanH62 = taggedContent.CreateSpanElement();
        spanH62.SetText("Level 6 Header");
        h6.AppendChild(spanH62);

        Aspose.Pdf.LogicalStructure.ParagraphElement p = taggedContent.CreateParagraphElement();
        p.SetText("P. ");
        rootElement.AppendChild(p);
        Aspose.Pdf.LogicalStructure.SpanElement span1 = taggedContent.CreateSpanElement();
        span1.SetText("Lorem ipsum dolor sit amet, consectetur adipiscing elit. ");
        p.AppendChild(span1);
        Aspose.Pdf.LogicalStructure.SpanElement span2 = taggedContent.CreateSpanElement();
        span2.SetText("Aenean nec lectus ac sem faucibus imperdiet. ");
        p.AppendChild(span2);
        Aspose.Pdf.LogicalStructure.SpanElement span3 = taggedContent.CreateSpanElement();
        span3.SetText("Sed ut erat ac magna ullamcorper hendrerit. ");
        p.AppendChild(span3);
        Aspose.Pdf.LogicalStructure.SpanElement span4 = taggedContent.CreateSpanElement();
        span4.SetText("Cras pellentesque libero semper, gravida magna sed, luctus leo. ");
        p.AppendChild(span4);
        Aspose.Pdf.LogicalStructure.SpanElement span5 = taggedContent.CreateSpanElement();
        span5.SetText("Fusce lectus odio, laoreet nec ullamcorper ut, molestie eu elit. ");
        p.AppendChild(span5);
        Aspose.Pdf.LogicalStructure.SpanElement span6 = taggedContent.CreateSpanElement();
        span6.SetText("Interdum et malesuada fames ac ante ipsum primis in faucibus. ");
        p.AppendChild(span6);
        Aspose.Pdf.LogicalStructure.SpanElement span7 = taggedContent.CreateSpanElement();
        span7.SetText("Aliquam lacinia sit amet elit ac consectetur. Donec cursus condimentum ligula, vitae volutpat sem tristique eget. ");
        p.AppendChild(span7);
        Aspose.Pdf.LogicalStructure.SpanElement span8 = taggedContent.CreateSpanElement();
        span8.SetText("Nulla in consectetur massa. Vestibulum vitae lobortis ante. Nulla ullamcorper pellentesque justo rhoncus accumsan. ");
        p.AppendChild(span8);
        Aspose.Pdf.LogicalStructure.SpanElement span9 = taggedContent.CreateSpanElement();
        span9.SetText("Mauris ornare eu odio non lacinia. Aliquam massa leo, rhoncus ac iaculis eget, tempus et magna. Sed non consectetur elit. ");
        p.AppendChild(span9);
        Aspose.Pdf.LogicalStructure.SpanElement span10 = taggedContent.CreateSpanElement();
        span10.SetText("Sed vulputate, quam sed lacinia luctus, ipsum nibh fringilla purus, vitae posuere risus odio id massa. Cras sed venenatis lacus.");
        p.AppendChild(span10);

        // Save Tagged PDF Document
        document.Save(dataDir + "InlineStructureElements_out.pdf");
    }
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void SetInlineElements()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Create PDF Document
    using var document = new Aspose.Pdf.Document();

    // Get Content for work with Tagged PDF
    Aspose.Pdf.Tagged.ITaggedContent taggedContent = document.TaggedContent;

    // Set Title and Language for Document
    taggedContent.SetTitle("Tagged Pdf Document");
    taggedContent.SetLanguage("en-US");

    // Get Root Structure Element
    Aspose.Pdf.LogicalStructure.StructureElement rootElement = taggedContent.RootElement;

    Aspose.Pdf.LogicalStructure.HeaderElement h1 = taggedContent.CreateHeaderElement(1);
    Aspose.Pdf.LogicalStructure.HeaderElement h2 = taggedContent.CreateHeaderElement(2);
    Aspose.Pdf.LogicalStructure.HeaderElement h3 = taggedContent.CreateHeaderElement(3);
    Aspose.Pdf.LogicalStructure.HeaderElement h4 = taggedContent.CreateHeaderElement(4);
    Aspose.Pdf.LogicalStructure.HeaderElement h5 = taggedContent.CreateHeaderElement(5);
    Aspose.Pdf.LogicalStructure.HeaderElement h6 = taggedContent.CreateHeaderElement(6);
    rootElement.AppendChild(h1);
    rootElement.AppendChild(h2);
    rootElement.AppendChild(h3);
    rootElement.AppendChild(h4);
    rootElement.AppendChild(h5);
    rootElement.AppendChild(h6);

    Aspose.Pdf.LogicalStructure.SpanElement spanH11 = taggedContent.CreateSpanElement();
    spanH11.SetText("H1. ");
    h1.AppendChild(spanH11);
    Aspose.Pdf.LogicalStructure.SpanElement spanH12 = taggedContent.CreateSpanElement();
    spanH12.SetText("Level 1 Header");
    h1.AppendChild(spanH12);

    Aspose.Pdf.LogicalStructure.SpanElement spanH21 = taggedContent.CreateSpanElement();
    spanH21.SetText("H2. ");
    h2.AppendChild(spanH21);
    Aspose.Pdf.LogicalStructure.SpanElement spanH22 = taggedContent.CreateSpanElement();
    spanH22.SetText("Level 2 Header");
    h2.AppendChild(spanH22);

    Aspose.Pdf.LogicalStructure.SpanElement spanH31 = taggedContent.CreateSpanElement();
    spanH31.SetText("H3. ");
    h3.AppendChild(spanH31);
    Aspose.Pdf.LogicalStructure.SpanElement spanH32 = taggedContent.CreateSpanElement();
    spanH32.SetText("Level 3 Header");
    h3.AppendChild(spanH32);

    Aspose.Pdf.LogicalStructure.SpanElement spanH41 = taggedContent.CreateSpanElement();
    spanH41.SetText("H4. ");
    h4.AppendChild(spanH41);
    Aspose.Pdf.LogicalStructure.SpanElement spanH42 = taggedContent.CreateSpanElement();
    spanH42.SetText("Level 4 Header");
    h4.AppendChild(spanH42);

    Aspose.Pdf.LogicalStructure.SpanElement spanH51 = taggedContent.CreateSpanElement();
    spanH51.SetText("H5. ");
    h5.AppendChild(spanH51);
    Aspose.Pdf.LogicalStructure.SpanElement spanH52 = taggedContent.CreateSpanElement();
    spanH52.SetText("Level 5 Header");
    h5.AppendChild(spanH52);

    Aspose.Pdf.LogicalStructure.SpanElement spanH61 = taggedContent.CreateSpanElement();
    spanH61.SetText("H6. ");
    h6.AppendChild(spanH61);
    Aspose.Pdf.LogicalStructure.SpanElement spanH62 = taggedContent.CreateSpanElement();
    spanH62.SetText("Level 6 Header");
    h6.AppendChild(spanH62);

    Aspose.Pdf.LogicalStructure.ParagraphElement p = taggedContent.CreateParagraphElement();
    p.SetText("P. ");
    rootElement.AppendChild(p);
    Aspose.Pdf.LogicalStructure.SpanElement span1 = taggedContent.CreateSpanElement();
    span1.SetText("Lorem ipsum dolor sit amet, consectetur adipiscing elit. ");
    p.AppendChild(span1);
    Aspose.Pdf.LogicalStructure.SpanElement span2 = taggedContent.CreateSpanElement();
    span2.SetText("Aenean nec lectus ac sem faucibus imperdiet. ");
    p.AppendChild(span2);
    Aspose.Pdf.LogicalStructure.SpanElement span3 = taggedContent.CreateSpanElement();
    span3.SetText("Sed ut erat ac magna ullamcorper hendrerit. ");
    p.AppendChild(span3);
    Aspose.Pdf.LogicalStructure.SpanElement span4 = taggedContent.CreateSpanElement();
    span4.SetText("Cras pellentesque libero semper, gravida magna sed, luctus leo. ");
    p.AppendChild(span4);
    Aspose.Pdf.LogicalStructure.SpanElement span5 = taggedContent.CreateSpanElement();
    span5.SetText("Fusce lectus odio, laoreet nec ullamcorper ut, molestie eu elit. ");
    p.AppendChild(span5);
    Aspose.Pdf.LogicalStructure.SpanElement span6 = taggedContent.CreateSpanElement();
    span6.SetText("Interdum et malesuada fames ac ante ipsum primis in faucibus. ");
    p.AppendChild(span6);
    Aspose.Pdf.LogicalStructure.SpanElement span7 = taggedContent.CreateSpanElement();
    span7.SetText("Aliquam lacinia sit amet elit ac consectetur. Donec cursus condimentum ligula, vitae volutpat sem tristique eget. ");
    p.AppendChild(span7);
    Aspose.Pdf.LogicalStructure.SpanElement span8 = taggedContent.CreateSpanElement();
    span8.SetText("Nulla in consectetur massa. Vestibulum vitae lobortis ante. Nulla ullamcorper pellentesque justo rhoncus accumsan. ");
    p.AppendChild(span8);
    Aspose.Pdf.LogicalStructure.SpanElement span9 = taggedContent.CreateSpanElement();
    span9.SetText("Mauris ornare eu odio non lacinia. Aliquam massa leo, rhoncus ac iaculis eget, tempus et magna. Sed non consectetur elit. ");
    p.AppendChild(span9);
    Aspose.Pdf.LogicalStructure.SpanElement span10 = taggedContent.CreateSpanElement();
    span10.SetText("Sed vulputate, quam sed lacinia luctus, ipsum nibh fringilla purus, vitae posuere risus odio id massa. Cras sed venenatis lacus.");
    p.AppendChild(span10);

    // Save Tagged PDF Document
    document.Save(dataDir + "InlineStructureElements_out.pdf");
}

设置自定义标签名称

为了设置标记 PDF 文档元素的自定义标签名称，Aspose.PDF 提供了 StructureElement 类的 SetTag 方法。以下代码片段展示了如何设置自定义标签名称：

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void SetTagName()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Create PDF Document
    using (var document = new Aspose.Pdf.Document())
    {
        // Get Content for work with Tagged PDF
        Aspose.Pdf.Tagged.ITaggedContent taggedContent = document.TaggedContent;

        // Set Title and Language for Document
        taggedContent.SetTitle("Tagged Pdf Document");
        taggedContent.SetLanguage("en-US");

        // Create Logical Structure Elements
        Aspose.Pdf.LogicalStructure.SectElement sect = taggedContent.CreateSectElement();
        taggedContent.RootElement.AppendChild(sect);

        Aspose.Pdf.LogicalStructure.ParagraphElement p1 = taggedContent.CreateParagraphElement();
        Aspose.Pdf.LogicalStructure.ParagraphElement p2 = taggedContent.CreateParagraphElement();
        Aspose.Pdf.LogicalStructure.ParagraphElement p3 = taggedContent.CreateParagraphElement();
        Aspose.Pdf.LogicalStructure.ParagraphElement p4 = taggedContent.CreateParagraphElement();

        p1.SetText("P1. ");
        p2.SetText("P2. ");
        p3.SetText("P3. ");
        p4.SetText("P4. ");

        p1.SetTag("P1");
        p2.SetTag("Para");
        p3.SetTag("Para");
        p4.SetTag("Paragraph");

        sect.AppendChild(p1);
        sect.AppendChild(p2);
        sect.AppendChild(p3);
        sect.AppendChild(p4);

        Aspose.Pdf.LogicalStructure.SpanElement span1 = taggedContent.CreateSpanElement();
        Aspose.Pdf.LogicalStructure.SpanElement span2 = taggedContent.CreateSpanElement();
        Aspose.Pdf.LogicalStructure.SpanElement span3 = taggedContent.CreateSpanElement();
        Aspose.Pdf.LogicalStructure.SpanElement span4 = taggedContent.CreateSpanElement();

        span1.SetText("Span 1.");
        span2.SetText("Span 2.");
        span3.SetText("Span 3.");
        span4.SetText("Span 4.");

        span1.SetTag("SPAN");
        span2.SetTag("Sp");
        span3.SetTag("Sp");
        span4.SetTag("TheSpan");

        p1.AppendChild(span1);
        p2.AppendChild(span2);
        p3.AppendChild(span3);
        p4.AppendChild(span4);

        // Save Tagged PDF Document
        document.Save(dataDir + "CustomTag_out.pdf");
    }
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void SetTagName()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Create PDF Document
    using var document = new Aspose.Pdf.Document();

    // Get Content for work with Tagged PDF
    Aspose.Pdf.Tagged.ITaggedContent taggedContent = document.TaggedContent;

    // Set Title and Language for Document
    taggedContent.SetTitle("Tagged Pdf Document");
    taggedContent.SetLanguage("en-US");

    // Create Logical Structure Elements
    Aspose.Pdf.LogicalStructure.SectElement sect = taggedContent.CreateSectElement();
    taggedContent.RootElement.AppendChild(sect);

    Aspose.Pdf.LogicalStructure.ParagraphElement p1 = taggedContent.CreateParagraphElement();
    Aspose.Pdf.LogicalStructure.ParagraphElement p2 = taggedContent.CreateParagraphElement();
    Aspose.Pdf.LogicalStructure.ParagraphElement p3 = taggedContent.CreateParagraphElement();
    Aspose.Pdf.LogicalStructure.ParagraphElement p4 = taggedContent.CreateParagraphElement();

    p1.SetText("P1. ");
    p2.SetText("P2. ");
    p3.SetText("P3. ");
    p4.SetText("P4. ");

    p1.SetTag("P1");
    p2.SetTag("Para");
    p3.SetTag("Para");
    p4.SetTag("Paragraph");

    sect.AppendChild(p1);
    sect.AppendChild(p2);
    sect.AppendChild(p3);
    sect.AppendChild(p4);

    Aspose.Pdf.LogicalStructure.SpanElement span1 = taggedContent.CreateSpanElement();
    Aspose.Pdf.LogicalStructure.SpanElement span2 = taggedContent.CreateSpanElement();
    Aspose.Pdf.LogicalStructure.SpanElement span3 = taggedContent.CreateSpanElement();
    Aspose.Pdf.LogicalStructure.SpanElement span4 = taggedContent.CreateSpanElement();

    span1.SetText("Span 1.");
    span2.SetText("Span 2.");
    span3.SetText("Span 3.");
    span4.SetText("Span 4.");

    span1.SetTag("SPAN");
    span2.SetTag("Sp");
    span3.SetTag("Sp");
    span4.SetTag("TheSpan");

    p1.AppendChild(span1);
    p2.AppendChild(span2);
    p3.AppendChild(span3);
    p4.AppendChild(span4);

    // Save Tagged PDF Document
    document.Save(dataDir + "CustomTag_out.pdf");
}

将结构元素添加到元素中

此功能支持版本 19.4 或更高版本。

为了在标记 PDF 文档中设置链接结构元素，Aspose.PDF 提供了 CreateLinkElement 方法，属于 ITaggedContent 接口。以下代码片段展示了如何在标记 PDF 文档的段落中设置结构元素：

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void SetElements()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Create PDF document
    using (var document = new Aspose.Pdf.Document())
    {
        Aspose.Pdf.Tagged.ITaggedContent taggedContent = document.TaggedContent;

        // Setting Title and Nature Language for document
        taggedContent.SetTitle("Link Elements Example");
        taggedContent.SetLanguage("en-US");

        // Getting Root structure element (Document structure element)
        Aspose.Pdf.LogicalStructure.StructureElement rootElement = taggedContent.RootElement;

        Aspose.Pdf.LogicalStructure.ParagraphElement p1 = taggedContent.CreateParagraphElement();
        rootElement.AppendChild(p1);
        Aspose.Pdf.LogicalStructure.LinkElement link1 = taggedContent.CreateLinkElement();
        p1.AppendChild(link1);
        link1.Hyperlink = new Aspose.Pdf.WebHyperlink("http://google.com");
        link1.SetText("Google");
        link1.AlternateDescriptions = "Link to Google";

        Aspose.Pdf.LogicalStructure.ParagraphElement p2 = taggedContent.CreateParagraphElement();
        rootElement.AppendChild(p2);
        Aspose.Pdf.LogicalStructure.LinkElement link2 = taggedContent.CreateLinkElement();
        p2.AppendChild(link2);
        link2.Hyperlink = new Aspose.Pdf.WebHyperlink("http://google.com");
        Aspose.Pdf.LogicalStructure.SpanElement span2 = taggedContent.CreateSpanElement();
        span2.SetText("Google");
        link2.AppendChild(span2);
        link2.AlternateDescriptions = "Link to Google";

        Aspose.Pdf.LogicalStructure.ParagraphElement p3 = taggedContent.CreateParagraphElement();
        rootElement.AppendChild(p3);
        Aspose.Pdf.LogicalStructure.LinkElement link3 = taggedContent.CreateLinkElement();
        p3.AppendChild(link3);
        link3.Hyperlink = new Aspose.Pdf.WebHyperlink("http://google.com");
        Aspose.Pdf.LogicalStructure.SpanElement span31 = taggedContent.CreateSpanElement();
        span31.SetText("G");
        Aspose.Pdf.LogicalStructure.SpanElement span32 = taggedContent.CreateSpanElement();
        span32.SetText("oogle");
        link3.AppendChild(span31);
        link3.SetText("-");
        link3.AppendChild(span32);
        link3.AlternateDescriptions = "Link to Google";

        Aspose.Pdf.LogicalStructure.ParagraphElement p4 = taggedContent.CreateParagraphElement();
        rootElement.AppendChild(p4);
        Aspose.Pdf.LogicalStructure.LinkElement link4 = taggedContent.CreateLinkElement();
        p4.AppendChild(link4);
        link4.Hyperlink = new Aspose.Pdf.WebHyperlink("http://google.com");
        link4.SetText("The multiline link: Google Google Google Google Google Google Google Google Google Google Google Google Google Google Google Google Google Google Google Google");
        link4.AlternateDescriptions = "Link to Google (multiline)";

        Aspose.Pdf.LogicalStructure.ParagraphElement p5 = taggedContent.CreateParagraphElement();
        rootElement.AppendChild(p5);
        Aspose.Pdf.LogicalStructure.LinkElement link5 = taggedContent.CreateLinkElement();
        p5.AppendChild(link5);
        link5.Hyperlink = new Aspose.Pdf.WebHyperlink("http://google.com");
        Aspose.Pdf.LogicalStructure.FigureElement figure5 = taggedContent.CreateFigureElement();
        figure5.SetImage(dataDir + "google-icon-512.png", 1200);
        figure5.AlternativeText = "Google icon";
        Aspose.Pdf.LogicalStructure.StructureAttributes linkLayoutAttributes = link5.Attributes.GetAttributes(Aspose.Pdf.LogicalStructure.AttributeOwnerStandard.Layout);
        var placementAttribute = new Aspose.Pdf.LogicalStructure.StructureAttribute(Aspose.Pdf.LogicalStructure.AttributeKey.Placement);
        placementAttribute.SetNameValue(Aspose.Pdf.LogicalStructure.AttributeName.Placement_Block);
        linkLayoutAttributes.SetAttribute(placementAttribute);
        link5.AppendChild(figure5);
        link5.AlternateDescriptions = "Link to Google";

        // Save Tagged PDF Document
        document.Save(dataDir + "LinkStructureElements_out.pdf");
    }

    // Check PDF/UA compliance
    using (var document = new Aspose.Pdf.Document(dataDir + "LinkStructureElements_out.pdf"))
    {
        bool isPdfUaCompliance = document.Validate(dataDir + "LinkStructureElements_log.xml", Aspose.Pdf.PdfFormat.PDF_UA_1);
        Console.WriteLine(String.Format("PDF/UA compliance: {0}", isPdfUaCompliance));
    }
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void SetElements()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Create PDF document
    using var document1 = new Aspose.Pdf.Document();
    Aspose.Pdf.Tagged.ITaggedContent taggedContent = document1.TaggedContent;

    // Setting Title and Nature Language for document
    taggedContent.SetTitle("Link Elements Example");
    taggedContent.SetLanguage("en-US");

    // Getting Root structure element (Document structure element)
    Aspose.Pdf.LogicalStructure.StructureElement rootElement = taggedContent.RootElement;

    Aspose.Pdf.LogicalStructure.ParagraphElement p1 = taggedContent.CreateParagraphElement();
    rootElement.AppendChild(p1);
    Aspose.Pdf.LogicalStructure.LinkElement link1 = taggedContent.CreateLinkElement();
    p1.AppendChild(link1);
    link1.Hyperlink = new Aspose.Pdf.WebHyperlink("http://google.com");
    link1.SetText("Google");
    link1.AlternateDescriptions = "Link to Google";

    Aspose.Pdf.LogicalStructure.ParagraphElement p2 = taggedContent.CreateParagraphElement();
    rootElement.AppendChild(p2);
    Aspose.Pdf.LogicalStructure.LinkElement link2 = taggedContent.CreateLinkElement();
    p2.AppendChild(link2);
    link2.Hyperlink = new Aspose.Pdf.WebHyperlink("http://google.com");
    Aspose.Pdf.LogicalStructure.SpanElement span2 = taggedContent.CreateSpanElement();
    span2.SetText("Google");
    link2.AppendChild(span2);
    link2.AlternateDescriptions = "Link to Google";

    Aspose.Pdf.LogicalStructure.ParagraphElement p3 = taggedContent.CreateParagraphElement();
    rootElement.AppendChild(p3);
    Aspose.Pdf.LogicalStructure.LinkElement link3 = taggedContent.CreateLinkElement();
    p3.AppendChild(link3);
    link3.Hyperlink = new Aspose.Pdf.WebHyperlink("http://google.com");
    Aspose.Pdf.LogicalStructure.SpanElement span31 = taggedContent.CreateSpanElement();
    span31.SetText("G");
    Aspose.Pdf.LogicalStructure.SpanElement span32 = taggedContent.CreateSpanElement();
    span32.SetText("oogle");
    link3.AppendChild(span31);
    link3.SetText("-");
    link3.AppendChild(span32);
    link3.AlternateDescriptions = "Link to Google";

    Aspose.Pdf.LogicalStructure.ParagraphElement p4 = taggedContent.CreateParagraphElement();
    rootElement.AppendChild(p4);
    Aspose.Pdf.LogicalStructure.LinkElement link4 = taggedContent.CreateLinkElement();
    p4.AppendChild(link4);
    link4.Hyperlink = new Aspose.Pdf.WebHyperlink("http://google.com");
    link4.SetText("The multiline link: Google Google Google Google Google Google Google Google Google Google Google Google Google Google Google Google Google Google Google Google");
    link4.AlternateDescriptions = "Link to Google (multiline)";

    Aspose.Pdf.LogicalStructure.ParagraphElement p5 = taggedContent.CreateParagraphElement();
    rootElement.AppendChild(p5);
    Aspose.Pdf.LogicalStructure.LinkElement link5 = taggedContent.CreateLinkElement();
    p5.AppendChild(link5);
    link5.Hyperlink = new Aspose.Pdf.WebHyperlink("http://google.com");
    Aspose.Pdf.LogicalStructure.FigureElement figure5 = taggedContent.CreateFigureElement();
    figure5.SetImage(dataDir + "google-icon-512.png", 1200);
    figure5.AlternativeText = "Google icon";
    Aspose.Pdf.LogicalStructure.StructureAttributes linkLayoutAttributes = link5.Attributes.GetAttributes(Aspose.Pdf.LogicalStructure.AttributeOwnerStandard.Layout);
    var placementAttribute = new Aspose.Pdf.LogicalStructure.StructureAttribute(Aspose.Pdf.LogicalStructure.AttributeKey.Placement);
    placementAttribute.SetNameValue(Aspose.Pdf.LogicalStructure.AttributeName.Placement_Block);
    linkLayoutAttributes.SetAttribute(placementAttribute);
    link5.AppendChild(figure5);
    link5.AlternateDescriptions = "Link to Google";

    // Save Tagged PDF Document
    document1.Save(dataDir + "LinkStructureElements_out.pdf");

    // Check PDF/UA compliance
    using var document2 = new Aspose.Pdf.Document(dataDir + "LinkStructureElements_out.pdf");
    bool isPdfUaCompliance = document2.Validate(dataDir + "LinkStructureElements_log.xml", Aspose.Pdf.PdfFormat.PDF_UA_1);
    Console.WriteLine(String.Format("PDF/UA compliance: {0}", isPdfUaCompliance));
}

设置链接结构元素

此功能支持版本 19.4 或更高版本。

Aspose.PDF for .NET API 还允许您添加链接结构元素。以下代码片段展示了如何将链接结构元素添加到标记 PDF 文档中：

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void AddLinkElement()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Create PDF document
    using (var document = new Aspose.Pdf.Document())
    {
        Aspose.Pdf.Tagged.ITaggedContent taggedContent = document.TaggedContent;

        // Setting Title and Nature Language for document
        taggedContent.SetTitle("Text Elements Example");
        taggedContent.SetLanguage("en-US");

        // Getting Root structure element (Document structure element)
        Aspose.Pdf.LogicalStructure.StructureElement rootElement = taggedContent.RootElement;

        Aspose.Pdf.LogicalStructure.ParagraphElement p1 = taggedContent.CreateParagraphElement();
        rootElement.AppendChild(p1);
        Aspose.Pdf.LogicalStructure.SpanElement span11 = taggedContent.CreateSpanElement();
        span11.SetText("Span_11");
        Aspose.Pdf.LogicalStructure.SpanElement span12 = taggedContent.CreateSpanElement();
        span12.SetText(" and Span_12.");
        p1.SetText("Paragraph with ");
        p1.AppendChild(span11);
        p1.AppendChild(span12);

        Aspose.Pdf.LogicalStructure.ParagraphElement p2 = taggedContent.CreateParagraphElement();
        rootElement.AppendChild(p2);
        Aspose.Pdf.LogicalStructure.SpanElement span21 = taggedContent.CreateSpanElement();
        span21.SetText("Span_21");
        Aspose.Pdf.LogicalStructure.SpanElement span22 = taggedContent.CreateSpanElement();
        span22.SetText("Span_22.");
        p2.AppendChild(span21);
        p2.SetText(" and ");
        p2.AppendChild(span22);

        Aspose.Pdf.LogicalStructure.ParagraphElement p3 = taggedContent.CreateParagraphElement();
        rootElement.AppendChild(p3);
        Aspose.Pdf.LogicalStructure.SpanElement span31 = taggedContent.CreateSpanElement();
        span31.SetText("Span_31");
        Aspose.Pdf.LogicalStructure.SpanElement span32 = taggedContent.CreateSpanElement();
        span32.SetText(" and Span_32");
        p3.AppendChild(span31);
        p3.AppendChild(span32);
        p3.SetText(".");

        Aspose.Pdf.LogicalStructure.ParagraphElement p4 = taggedContent.CreateParagraphElement();
        rootElement.AppendChild(p4);
        Aspose.Pdf.LogicalStructure.SpanElement span41 = taggedContent.CreateSpanElement();
        Aspose.Pdf.LogicalStructure.SpanElement span411 = taggedContent.CreateSpanElement();
        span411.SetText("Span_411, ");
        span41.SetText("Span_41, ");
        span41.AppendChild(span411);
        Aspose.Pdf.LogicalStructure.SpanElement span42 = taggedContent.CreateSpanElement();
        Aspose.Pdf.LogicalStructure.SpanElement span421 = taggedContent.CreateSpanElement();
        span421.SetText("Span 421 and ");
        span42.AppendChild(span421);
        span42.SetText("Span_42");
        p4.AppendChild(span41);
        p4.AppendChild(span42);
        p4.SetText(".");

        // Save Tagged PDF Document
        document.Save(dataDir + "AddStructureElementIntoElement_out.pdf");
    }

    // Check PDF/UA compliance
    using (var document = new Aspose.Pdf.Document(dataDir + "AddStructureElementIntoElement_out.pdf"))
    {
        bool isPdfUaCompliance = document.Validate(dataDir + "46144_log.xml", Aspose.Pdf.PdfFormat.PDF_UA_1);
        Console.WriteLine(String.Format("PDF/UA compliance: {0}", isPdfUaCompliance));
    }
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void AddLinkElement()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Create PDF document
    using var document1 = new Aspose.Pdf.Document();
    Aspose.Pdf.Tagged.ITaggedContent taggedContent = document1.TaggedContent;

    // Setting Title and Nature Language for document
    taggedContent.SetTitle("Text Elements Example");
    taggedContent.SetLanguage("en-US");

    // Getting Root structure element (Document structure element)
    Aspose.Pdf.LogicalStructure.StructureElement rootElement = taggedContent.RootElement;

    Aspose.Pdf.LogicalStructure.ParagraphElement p1 = taggedContent.CreateParagraphElement();
    rootElement.AppendChild(p1);
    Aspose.Pdf.LogicalStructure.SpanElement span11 = taggedContent.CreateSpanElement();
    span11.SetText("Span_11");
    Aspose.Pdf.LogicalStructure.SpanElement span12 = taggedContent.CreateSpanElement();
    span12.SetText(" and Span_12.");
    p1.SetText("Paragraph with ");
    p1.AppendChild(span11);
    p1.AppendChild(span12);

    Aspose.Pdf.LogicalStructure.ParagraphElement p2 = taggedContent.CreateParagraphElement();
    rootElement.AppendChild(p2);
    Aspose.Pdf.LogicalStructure.SpanElement span21 = taggedContent.CreateSpanElement();
    span21.SetText("Span_21");
    Aspose.Pdf.LogicalStructure.SpanElement span22 = taggedContent.CreateSpanElement();
    span22.SetText("Span_22.");
    p2.AppendChild(span21);
    p2.SetText(" and ");
    p2.AppendChild(span22);

    Aspose.Pdf.LogicalStructure.ParagraphElement p3 = taggedContent.CreateParagraphElement();
    rootElement.AppendChild(p3);
    Aspose.Pdf.LogicalStructure.SpanElement span31 = taggedContent.CreateSpanElement();
    span31.SetText("Span_31");
    Aspose.Pdf.LogicalStructure.SpanElement span32 = taggedContent.CreateSpanElement();
    span32.SetText(" and Span_32");
    p3.AppendChild(span31);
    p3.AppendChild(span32);
    p3.SetText(".");

    Aspose.Pdf.LogicalStructure.ParagraphElement p4 = taggedContent.CreateParagraphElement();
    rootElement.AppendChild(p4);
    Aspose.Pdf.LogicalStructure.SpanElement span41 = taggedContent.CreateSpanElement();
    Aspose.Pdf.LogicalStructure.SpanElement span411 = taggedContent.CreateSpanElement();
    span411.SetText("Span_411, ");
    span41.SetText("Span_41, ");
    span41.AppendChild(span411);
    Aspose.Pdf.LogicalStructure.SpanElement span42 = taggedContent.CreateSpanElement();
    Aspose.Pdf.LogicalStructure.SpanElement span421 = taggedContent.CreateSpanElement();
    span421.SetText("Span 421 and ");
    span42.AppendChild(span421);
    span42.SetText("Span_42");
    p4.AppendChild(span41);
    p4.AppendChild(span42);
    p4.SetText(".");

    // Save Tagged PDF Document
    document1.Save(dataDir + "AddStructureElementIntoElement_out.pdf");

    // Check PDF/UA compliance
    using var document2 = new Aspose.Pdf.Document(dataDir + "AddStructureElementIntoElement_out.pdf");
    bool isPdfUaCompliance = document2.Validate(dataDir + "46144_log.xml", Aspose.Pdf.PdfFormat.PDF_UA_1);
    Console.WriteLine(String.Format("PDF/UA compliance: {0}", isPdfUaCompliance));
}

设置注释结构元素

Aspose.PDF for .NET API 还允许您在标记 PDF 文档中添加 NoteElement。以下代码片段展示了如何在标记 PDF 文档中添加注释元素：

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void SetNoteElement()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Create PDF Document
    using (var document = new Aspose.Pdf.Document())
    {
        Aspose.Pdf.Tagged.ITaggedContent taggedContent = document.TaggedContent;

        taggedContent.SetTitle("Sample of Note Elements");
        taggedContent.SetLanguage("en-US");

        // Add Paragraph Element
        Aspose.Pdf.LogicalStructure.ParagraphElement paragraph = taggedContent.CreateParagraphElement();
        taggedContent.RootElement.AppendChild(paragraph);

        // Add NoteElement
        Aspose.Pdf.LogicalStructure.NoteElement note1 = taggedContent.CreateNoteElement();
        paragraph.AppendChild(note1);
        note1.SetText("Note with auto generate ID. ");

        // Add NoteElement
        Aspose.Pdf.LogicalStructure.NoteElement note2 = taggedContent.CreateNoteElement();
        paragraph.AppendChild(note2);
        note2.SetText("Note with ID = 'note_002'. ");
        note2.SetId("note_002");

        // Add NoteElement
        Aspose.Pdf.LogicalStructure.NoteElement note3 = taggedContent.CreateNoteElement();
        paragraph.AppendChild(note3);
        note3.SetText("Note with ID = 'note_003'. ");
        note3.SetId("note_003");

        // Must throw exception - Aspose.Pdf.Tagged.TaggedException : Structure element with ID='note_002' already exists
        //note3.SetId("note_002");

        // Resultant document does not compliance to PDF/UA If ClearId() used for Note Structure Element
        //note3.ClearId();

        // Save Tagged PDF Document
        document.Save(dataDir + "SetNoteElement_out.pdf");
    }

    // Check PDF/UA compliance
    using (var document = new Aspose.Pdf.Document(dataDir + "SetNoteElement_out.pdf"))
    {
        bool isPdfUaCompliance = document.Validate(dataDir + "SetNoteElement_log.xml", Aspose.Pdf.PdfFormat.PDF_UA_1);
        Console.WriteLine(String.Format("PDF/UA compliance: {0}", isPdfUaCompliance));
    }
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void SetNoteElement()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Create PDF Document
    using var document1 = new Aspose.Pdf.Document();
    Aspose.Pdf.Tagged.ITaggedContent taggedContent = document1.TaggedContent;

    taggedContent.SetTitle("Sample of Note Elements");
    taggedContent.SetLanguage("en-US");

    // Add Paragraph Element
    Aspose.Pdf.LogicalStructure.ParagraphElement paragraph = taggedContent.CreateParagraphElement();
    taggedContent.RootElement.AppendChild(paragraph);

    // Add NoteElement
    Aspose.Pdf.LogicalStructure.NoteElement note1 = taggedContent.CreateNoteElement();
    paragraph.AppendChild(note1);
    note1.SetText("Note with auto generate ID. ");

    // Add NoteElement
    Aspose.Pdf.LogicalStructure.NoteElement note2 = taggedContent.CreateNoteElement();
    paragraph.AppendChild(note2);
    note2.SetText("Note with ID = 'note_002'. ");
    note2.SetId("note_002");

    // Add NoteElement
    Aspose.Pdf.LogicalStructure.NoteElement note3 = taggedContent.CreateNoteElement();
    paragraph.AppendChild(note3);
    note3.SetText("Note with ID = 'note_003'. ");
    note3.SetId("note_003");

    // Must throw exception - Aspose.Pdf.Tagged.TaggedException : Structure element with ID='note_002' already exists
    //note3.SetId("note_002");

    // Resultant document does not compliance to PDF/UA If ClearId() used for Note Structure Element
    //note3.ClearId();

    // Save Tagged PDF Document
    document1.Save(dataDir + "SetNoteElement_out.pdf");

    // Check PDF/UA compliance
    using var document2 = new Aspose.Pdf.Document(dataDir + "SetNoteElement_out.pdf");
    bool isPdfUaCompliance = document2.Validate(dataDir + "SetNoteElement_log.xml", Aspose.Pdf.PdfFormat.PDF_UA_1);
    Console.WriteLine(String.Format("PDF/UA compliance: {0}", isPdfUaCompliance));
}

设置语言和标题

此功能支持版本 19.6 或更高版本。

Aspose.PDF for .NET API 还允许您根据 PDF/UA 规范为文档设置语言和标题。语言可以为整个文档或其单独的结构元素设置。以下代码片段展示了如何在标记 PDF 文档中设置语言和标题：

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void SetLanguageAndTitle()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Create PDF Document
    using (var document = new Aspose.Pdf.Document())
    {
        // Get TaggedContent
        Aspose.Pdf.Tagged.ITaggedContent taggedContent = document.TaggedContent;

        // Set Title and Language
        taggedContent.SetTitle("Example Tagged Document");
        taggedContent.SetLanguage("en-US");

        // Header (en-US, inherited from document)
        Aspose.Pdf.LogicalStructure.HeaderElement h1 = taggedContent.CreateHeaderElement(1);
        h1.SetText("Phrase on different languages");
        taggedContent.RootElement.AppendChild(h1);

        // Paragraph (English)
        Aspose.Pdf.LogicalStructure.ParagraphElement pEN = taggedContent.CreateParagraphElement();
        pEN.SetText("Hello, World!");
        pEN.Language = "en-US";
        taggedContent.RootElement.AppendChild(pEN);

        // Paragraph (German)
        Aspose.Pdf.LogicalStructure.ParagraphElement pDE = taggedContent.CreateParagraphElement();
        pDE.SetText("Hallo Welt!");
        pDE.Language = "de-DE";
        taggedContent.RootElement.AppendChild(pDE);

        // Paragraph (French)
        Aspose.Pdf.LogicalStructure.ParagraphElement pFR = taggedContent.CreateParagraphElement();
        pFR.SetText("Bonjour le monde!");
        pFR.Language = "fr-FR";
        taggedContent.RootElement.AppendChild(pFR);

        // Paragraph (Spanish)
        Aspose.Pdf.LogicalStructure.ParagraphElement pSP = taggedContent.CreateParagraphElement();
        pSP.SetText("¡Hola Mundo!");
        pSP.Language = "es-ES";
        taggedContent.RootElement.AppendChild(pSP);

        // Save Tagged PDF Document
        document.Save(dataDir + "SetupLanguageAndTitle_out.pdf");
    }
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void SetLanguageAndTitle()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Create PDF Document
    using var document = new Aspose.Pdf.Document();

    // Get TaggedContent
    Aspose.Pdf.Tagged.ITaggedContent taggedContent = document.TaggedContent;

    // Set Title and Language
    taggedContent.SetTitle("Example Tagged Document");
    taggedContent.SetLanguage("en-US");

    // Header (en-US, inherited from document)
    Aspose.Pdf.LogicalStructure.HeaderElement h1 = taggedContent.CreateHeaderElement(1);
    h1.SetText("Phrase on different languages");
    taggedContent.RootElement.AppendChild(h1);

    // Paragraph (English)
    Aspose.Pdf.LogicalStructure.ParagraphElement pEN = taggedContent.CreateParagraphElement();
    pEN.SetText("Hello, World!");
    pEN.Language = "en-US";
    taggedContent.RootElement.AppendChild(pEN);

    // Paragraph (German)
    Aspose.Pdf.LogicalStructure.ParagraphElement pDE = taggedContent.CreateParagraphElement();
    pDE.SetText("Hallo Welt!");
    pDE.Language = "de-DE";
    taggedContent.RootElement.AppendChild(pDE);

    // Paragraph (French)
    Aspose.Pdf.LogicalStructure.ParagraphElement pFR = taggedContent.CreateParagraphElement();
    pFR.SetText("Bonjour le monde!");
    pFR.Language = "fr-FR";
    taggedContent.RootElement.AppendChild(pFR);

    // Paragraph (Spanish)
    Aspose.Pdf.LogicalStructure.ParagraphElement pSP = taggedContent.CreateParagraphElement();
    pSP.SetText("¡Hola Mundo!");
    pSP.Language = "es-ES";
    taggedContent.RootElement.AppendChild(pSP);

    // Save Tagged PDF Document
    document.Save(dataDir + "SetupLanguageAndTitle.pdf");
}