إعداد خصائص عناصر الهيكل

لتعيين خصائص عناصر الهيكل في مستند 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 طريقة SetTag من فئة StructureElement للعناصر. تظهر مقتطفات الكود التالية كيفية تعيين اسم علامة مخصصة:

.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 أيضًا إضافة عناصر الهيكل المرتبطة. تظهر مقتطفات الكود التالية كيفية إضافة عنصر الهيكل المرتبط إلى مستند 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 أيضًا إضافة NoteElement في مستند PDF مع علامات. تظهر مقتطفات الكود التالية كيفية إضافة عنصر الملاحظة في مستند 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 أيضًا تعيين اللغة والعنوان لمستند وفقًا لمواصفات 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");
}