C#를 사용하여 태그가 있는 PDF 만들기

태그가 있는 PDF를 생성한다는 것은 PDF/UA 요구 사항에 따라 문서를 검증할 수 있도록 특정 요소를 문서에 추가(또는 생성)하는 것을 의미합니다. 이러한 요소는 종종 구조 요소라고 불립니다.

다음 코드 스니펫은 Aspose.PDF.Drawing 라이브러리와 함께 작동합니다.

태그가 있는 PDF 만들기 (간단한 시나리오)

태그가 있는 PDF 문서에서 구조 요소를 생성하기 위해 Aspose.PDF는 ITaggedContent 인터페이스를 사용하여 구조 요소를 생성하는 메서드를 제공합니다. 다음 코드 스니펫은 헤더와 단락의 2개 요소가 포함된 태그가 있는 PDF를 만드는 방법을 보여줍니다.

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void CreateTaggedPdfDocument01()
{
    // 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;
        var rootElement = taggedContent.RootElement;

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

        Aspose.Pdf.LogicalStructure.HeaderElement mainHeader = taggedContent.CreateHeaderElement();
        mainHeader.SetText("Main Header");

        Aspose.Pdf.LogicalStructure.ParagraphElement paragraphElement = taggedContent.CreateParagraphElement();
        paragraphElement.SetText("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(mainHeader);
        rootElement.AppendChild(paragraphElement);

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

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void CreateTaggedPdfDocument01()
{
    // 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;
    var rootElement = taggedContent.RootElement;

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

    Aspose.Pdf.LogicalStructure.HeaderElement mainHeader = taggedContent.CreateHeaderElement();
    mainHeader.SetText("Main Header");

    Aspose.Pdf.LogicalStructure.ParagraphElement paragraphElement = taggedContent.CreateParagraphElement();
    paragraphElement.SetText("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(mainHeader);
    rootElement.AppendChild(paragraphElement);

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

생성 후 다음 문서를 얻을 수 있습니다:

중첩 요소가 있는 태그가 있는 PDF 만들기 (구조 요소 트리 생성)

경우에 따라 단락에 인용문을 배치하는 등 더 복잡한 구조를 생성해야 할 수 있습니다. 구조 요소 트리를 생성하기 위해 AppendChild 메서드를 사용해야 합니다. 다음 코드 스니펫은 태그가 있는 PDF 문서의 구조 요소 트리를 생성하는 방법을 보여줍니다:

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void CreateTaggedPdfDocument02()
{
    // 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;
        var rootElement = taggedContent.RootElement;

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

        Aspose.Pdf.LogicalStructure.HeaderElement header1 = taggedContent.CreateHeaderElement(1);
        header1.SetText("Header Level 1");

        Aspose.Pdf.LogicalStructure.ParagraphElement paragraphWithQuotes = taggedContent.CreateParagraphElement();
        paragraphWithQuotes.StructureTextState.Font = Aspose.Pdf.Text.FontRepository.FindFont("Calibri");
        paragraphWithQuotes.AdjustPosition(new Aspose.Pdf.Tagged.PositionSettings
            {
                Margin = new Aspose.Pdf.MarginInfo(10, 5, 10, 5)
            });

        Aspose.Pdf.LogicalStructure.SpanElement spanElement1 = taggedContent.CreateSpanElement();
        spanElement1.SetText("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. ");

        Aspose.Pdf.LogicalStructure.QuoteElement quoteElement = taggedContent.CreateQuoteElement();
        quoteElement.SetText("Sed vulputate, quam sed lacinia luctus, ipsum nibh fringilla purus, vitae posuere risus odio id massa.");
        quoteElement.StructureTextState.FontStyle = Aspose.Pdf.Text.FontStyles.Bold | Aspose.Pdf.Text.FontStyles.Italic;
        Aspose.Pdf.LogicalStructure.SpanElement spanElement2 = taggedContent.CreateSpanElement();
        spanElement2.SetText(" Sed non consectetur elit.");

        paragraphWithQuotes.AppendChild(spanElement1);
        paragraphWithQuotes.AppendChild(quoteElement);
        paragraphWithQuotes.AppendChild(spanElement2);

        rootElement.AppendChild(header1);
        rootElement.AppendChild(paragraphWithQuotes);

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

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void CreateTaggedPdfDocument02()
{
    // 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;
    var rootElement = taggedContent.RootElement;

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

    Aspose.Pdf.LogicalStructure.HeaderElement header1 = taggedContent.CreateHeaderElement(1);
    header1.SetText("Header Level 1");

    Aspose.Pdf.LogicalStructure.ParagraphElement paragraphWithQuotes = taggedContent.CreateParagraphElement();
    paragraphWithQuotes.StructureTextState.Font = Aspose.Pdf.Text.FontRepository.FindFont("Calibri");
    
    paragraphWithQuotes.AdjustPosition(new Aspose.Pdf.Tagged.PositionSettings
        {
            Margin = new Aspose.Pdf.MarginInfo(10, 5, 10, 5)
        });

    Aspose.Pdf.LogicalStructure.SpanElement spanElement1 = taggedContent.CreateSpanElement();
    spanElement1.SetText("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. ");

    Aspose.Pdf.LogicalStructure.QuoteElement quoteElement = taggedContent.CreateQuoteElement();
    quoteElement.SetText("Sed vulputate, quam sed lacinia luctus, ipsum nibh fringilla purus, vitae posuere risus odio id massa.");
    quoteElement.StructureTextState.FontStyle = Aspose.Pdf.Text.FontStyles.Bold | Aspose.Pdf.Text.FontStyles.Italic;
    Aspose.Pdf.LogicalStructure.SpanElement spanElement2 = taggedContent.CreateSpanElement();
    spanElement2.SetText(" Sed non consectetur elit.");

    paragraphWithQuotes.AppendChild(spanElement1);
    paragraphWithQuotes.AppendChild(quoteElement);
    paragraphWithQuotes.AppendChild(spanElement2);

    rootElement.AppendChild(header1);
    rootElement.AppendChild(paragraphWithQuotes);

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

생성 후 다음 문서를 얻을 수 있습니다:

텍스트 구조 스타일링

태그가 있는 PDF 문서에서 텍스트 구조를 스타일링하기 위해 Aspose.PDF는 Font, FontSize, FontStyle 및 ForegroundColor 속성을 StructureTextState 클래스에서 제공합니다. 다음 코드 스니펫은 태그가 있는 PDF 문서에서 텍스트 구조를 스타일링하는 방법을 보여줍니다:

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void AddStyle()
{
    // 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");

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

        p.StructureTextState.FontSize = 18F;
        p.StructureTextState.ForegroundColor = Aspose.Pdf.Color.Red;
        p.StructureTextState.FontStyle = Aspose.Pdf.Text.FontStyles.Italic;

        p.SetText("Red italic text.");

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

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void AddStyle()
{
    // 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");

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

    p.StructureTextState.FontSize = 18F;
    p.StructureTextState.ForegroundColor = Aspose.Pdf.Color.Red;
    p.StructureTextState.FontStyle = Aspose.Pdf.Text.FontStyles.Italic;

    p.SetText("Red italic text.");

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

구조 요소 설명

태그가 있는 PDF 문서에서 구조 요소를 설명하기 위해 Aspose.PDF는 IllustrationElement 클래스를 제공합니다. 다음 코드 스니펫은 태그가 있는 PDF 문서에서 구조 요소를 설명하는 방법을 보여줍니다:

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void IllustrateStructureElements()
{
    // 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");

        Aspose.Pdf.LogicalStructure.IllustrationElement figure1 = taggedContent.CreateFigureElement();
        taggedContent.RootElement.AppendChild(figure1);
        figure1.AlternativeText = "Figure One";
        figure1.Title = "Image 1";
        figure1.SetTag("Fig1");
        figure1.SetImage(dataDir + "image.png");
        
        // Adjust position
        figure1.AdjustPosition(new Aspose.Pdf.Tagged.PositionSettings
        {
            Margin = new Aspose.Pdf.MarginInfo
            {
                Left = 50,
                Top = 20
            },
        });

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

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void IllustrateStructureElements()
{
    // 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");

    Aspose.Pdf.LogicalStructure.IllustrationElement figure1 = taggedContent.CreateFigureElement();
    taggedContent.RootElement.AppendChild(figure1);
    figure1.AlternativeText = "Figure One";
    figure1.Title = "Image 1";
    figure1.SetTag("Fig1");
    figure1.SetImage(dataDir + "image.png");
    
    // Adjust position
    figure1.AdjustPosition(new Aspose.Pdf.Tagged.PositionSettings
    {
        Margin = new Aspose.Pdf.MarginInfo
        {
            Left = 50,
            Top = 20
        },
    });

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

태그가 있는 PDF 검증

Aspose.PDF for .NET는 PDF/UA 태그가 있는 PDF 문서를 검증할 수 있는 기능을 제공합니다. PDF/UA 표준의 검증은 다음을 지원합니다:

• XObjects 확인.
• Actions 확인.
• 선택적 콘텐츠 확인.
• 포함된 파일 확인.
• Acroform 필드 확인(자연어 및 대체 이름 및 디지털 서명 검증).
• XFA 양식 필드 확인.
• 보안 설정 확인.
• 탐색 확인.
• 주석 확인.

다음 코드 스니펫은 태그가 있는 PDF 문서를 검증하는 방법을 보여줍니다. 해당 문제는 XML 로그 보고서에 표시됩니다.

.NET Core 3.1

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

    // Open PDF document
    using (var document = new Aspose.Pdf.Document(dataDir + "StructureElements.pdf"))
    {
        bool isValid = document.Validate(dataDir + "StructureElements_log.xml", Aspose.Pdf.PdfFormat.PDF_UA_1);
    }
}

.NET 8

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

    // Open PDF document
    using var document = new Aspose.Pdf.Document(dataDir + "StructureElements.pdf");

    bool isValid = document.Validate(dataDir + "StructureElements_log.xml", Aspose.Pdf.PdfFormat.PDF_UA_1);
}

텍스트 구조 위치 조정

다음 코드 스니펫은 태그가 있는 PDF 문서에서 텍스트 구조 위치를 조정하는 방법을 보여줍니다:

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void AdjustPosition()
{
    // 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
        var taggedContent = document.TaggedContent;

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

        // Create paragraph
        var p = taggedContent.CreateParagraphElement();
        taggedContent.RootElement.AppendChild(p);
        p.SetText("Text.");

        // Adjust position
        p.AdjustPosition(new Aspose.Pdf.Tagged.PositionSettings
        {
            HorizontalAlignment = Aspose.Pdf.HorizontalAlignment.None,
            Margin = new Aspose.Pdf.MarginInfo
            {
                Left = 300,
                Right = 0,
                Top = 20,
                Bottom = 0
            },
            VerticalAlignment = Aspose.Pdf.VerticalAlignment.None,
            IsFirstParagraphInColumn = false,
            IsKeptWithNext = false,
            IsInNewPage = false,
            IsInLineParagraph = false
        });

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

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void AdjustPosition()
{
    // 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
    var taggedContent = document.TaggedContent;

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

    // Create paragraph
    var p = taggedContent.CreateParagraphElement();
    taggedContent.RootElement.AppendChild(p);
    p.SetText("Text.");

    // Adjust position
    p.AdjustPosition(new Aspose.Pdf.Tagged.PositionSettings
    {
        HorizontalAlignment = Aspose.Pdf.HorizontalAlignment.None,
        Margin = new Aspose.Pdf.MarginInfo
        {
            Left = 300,
            Right = 0,
            Top = 20,
            Bottom = 0
        },
        VerticalAlignment = Aspose.Pdf.VerticalAlignment.None,
        IsFirstParagraphInColumn = false,
        IsKeptWithNext = false,
        IsInNewPage = false,
        IsInLineParagraph = false
    });

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

PDF/UA-1 변환으로 태그가 있는 PDF 자동 생성

Aspose.PDF는 문서를 PDF/UA-1로 변환할 때 기본 논리 구조 마크업을 자동으로 생성할 수 있게 합니다. 사용자는 이후 이 기본 논리 구조를 수동으로 개선하여 문서 내용에 대한 추가 통찰력을 제공할 수 있습니다.

논리 문서 구조를 생성하려면 Aspose.Pdf.AutoTaggingSettings 클래스의 인스턴스를 생성하고, AutoTaggingSettings.EnableAutoTagging 속성을 true로 설정한 다음, PdfFormatConversionOptions.AutoTaggingSettings 속성에 할당합니다.

문서에 이미 논리 구조 태그가 있는 경우 자동 태그 생성을 활성화하면 기존 논리 구조가 파괴되고 새로운 구조가 생성됩니다.

.NET Core 3.1

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

    // Open PDF document
    using (Aspose.Pdf.Document document = new Aspose.Pdf.Document(dataDir + "BreakfastMenu.pdf"))
    {
        // Create conversion options
        Aspose.Pdf.PdfFormatConversionOptions options = new Aspose.Pdf.PdfFormatConversionOptions(dataDir + "ConvertToPdfUAWithAutomaticTagging.xml", PdfFormat.PDF_UA_1, ConvertErrorAction.Delete);

        // Create auto-tagging settings
        // Aspose.Pdf.AutoTaggingSettings.Default may be used to set the same settings as given below
        Aspose.Pdf.AutoTaggingSettings autoTaggingSettings = new Aspose.Pdf.AutoTaggingSettings();

        // Enable auto-tagging during the conversion process
        autoTaggingSettings.EnableAutoTagging = true;

        // Use the heading recognition strategy that's optimal for the given document structure
        autoTaggingSettings.HeadingRecognitionStrategy = Aspose.Pdf.HeadingRecognitionStrategy.Auto;

        // Assign auto-tagging settings to be used during the conversion process
        options.AutoTaggingSettings = autoTaggingSettings;

        // During the conversion, the document logical structure will be automatically created
        document.Convert(options);

        // Save PDF document
        document.Save(dataDir + "ConvertToPdfUAWithAutomaticTagging_out.pdf");
    }
}

.NET 8

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

    // Open PDF document
    using Aspose.Pdf.Document document = new Aspose.Pdf.Document(dataDir + "BreakfastMenu.pdf");

    // Create conversion options
    Aspose.Pdf.PdfFormatConversionOptions options = new Aspose.Pdf.PdfFormatConversionOptions(dataDir + "ConvertToPdfUAWithAutomaticTagging.xml", PdfFormat.PDF_UA_1, ConvertErrorAction.Delete);

    // Create auto-tagging settings
    // Aspose.Pdf.AutoTaggingSettings.Default may be used to set the same settings as given below
    Aspose.Pdf.AutoTaggingSettings autoTaggingSettings = new Aspose.Pdf.AutoTaggingSettings
    {
        // Enable auto-tagging during the conversion process
        EnableAutoTagging = true,

        // Use the heading recognition strategy that's optimal for the given document structure
        HeadingRecognitionStrategy = Aspose.Pdf.HeadingRecognitionStrategy.Auto
    };

    // Assign auto-tagging settings to be used during the conversion process
    options.AutoTaggingSettings = autoTaggingSettings;

    // During the conversion, the document logical structure will be automatically created
    document.Convert(options);

    // Save PDF document
    document.Save(dataDir + "ConvertToPdfUAWithAutomaticTagging_out.pdf");
}

양식 필드가 있는 태그가 있는 PDF 만들기

PDF 문서에서 대화형 양식 필드를 태그하여 접근성을 위한 논리 구조 트리에 포함되도록 할 수 있습니다 (PDF/UA). 아래 스니펫은 양식 필드를 생성하고, AcroForm에 등록하며, 구조 트리의 /Form 구조 요소와 연결하는 방법을 보여줍니다.

.NET Core 3.1

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

    // Create PDF document
    using (var document = new Aspose.Pdf.Document())
    {
        document.Pages.Add();
        
        // Get Content for work with TaggedPdf
        Aspose.Pdf.Tagged.ITaggedContent taggedContent = document.TaggedContent;
        Aspose.Pdf.LogicalStructure.StructureElement rootElement = taggedContent.RootElement;

        // Create a visible signature form field (AcroForm)
        var signatureField = new Aspose.Pdf.Forms.SignatureField(document.Pages[1], new Aspose.Pdf.Rectangle(50, 50, 100, 100));
        signatureField.PartialName = "Signature1";
        signatureField.AlternateName = "signature 1";
        
        // Add the signature field to the document's AcroForm
        document.Form.Add(signatureField);

        // Create a /Form structure element in the tag tree
        Aspose.Pdf.LogicalStructure.FormElement form = taggedContent.CreateFormElement();
        form.AlternativeText = "form 1";
        
        // Link the /Form tag to the signature field via an /OBJR reference
        form.Tag(signatureField);
        
        // Add the /Form structure element to the document’s logical structure tree
        rootElement.AppendChild(form);

        // Save PDF document
        document.Save(dataDir + "CreatePdfWithTaggedFormField_out.pdf");
    }
}

.NET 8

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

    // Create PDF document
    using var document = new Aspose.Pdf.Document();
    
    document.Pages.Add();
    
    // Get Content for work with TaggedPdf
    Aspose.Pdf.Tagged.ITaggedContent taggedContent = document.TaggedContent;
    Aspose.Pdf.LogicalStructure.StructureElement rootElement = taggedContent.RootElement;

    // Create a visible signature form field (AcroForm)
    var signatureField = new Aspose.Pdf.Forms.SignatureField(document.Pages[1], new Aspose.Pdf.Rectangle(50, 50, 100, 100));
    signatureField.PartialName = "Signature1";
    signatureField.AlternateName = "signature 1";
    
    // Add the signature field to the document's AcroForm
    document.Form.Add(signatureField);

    // Create a /Form structure element in the tag tree
    Aspose.Pdf.LogicalStructure.FormElement form = taggedContent.CreateFormElement();
    form.AlternativeText = "form 1";
    
    // Link the /Form tag to the signature field via an /OBJR reference
    form.Tag(signatureField);
    
    // Add the /Form structure element to the document’s logical structure tree
    rootElement.AppendChild(form);

    // Save PDF document
    document.Save(dataDir + "CreatePdfWithTaggedFormField_out.pdf");
}

목차(TOC) 페이지가 있는 태그가 있는 PDF 만들기

접근 가능한 목차(TOC) 페이지가 있는 태그가 있는 PDF 문서를 생성합니다.

.NET Core 3.1

    // For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
    private static void CreatePdfWithTOCpage()
    {
        // The path to the documents directory
        var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();
    
        // Create PDF document
        using (var doc = new Aspose.Pdf.Document())
        {
            // Get tagged content for the PDF structure
            Aspose.Pdf.Tagged.ITaggedContent content = doc.TaggedContent;
            Aspose.Pdf.LogicalStructure.StructureElement rootElement = content.RootElement;
            content.SetLanguage("en-US");
    
            // Add the table of contents (TOC) page
            Aspose.Pdf.Page tocPage = doc.Pages.Add();
            tocPage.TocInfo = new Aspose.Pdf.TocInfo();
    
            // Create a TOC structure element
            Aspose.Pdf.LogicalStructure.TOCElement tocElement = content.CreateTOCElement();
    
            // Add the TOC element to the document structure tree
            rootElement.AppendChild(tocElement);
    
            // Add a content page
            doc.Pages.Add();
    
            // Create a header element and set its text
            Aspose.Pdf.LogicalStructure.HeaderElement header = content.CreateHeaderElement(1);
            header.SetText("1. Header");
    
            // Add the header to the document structure
            rootElement.AppendChild(header);
    
            // Create a TOC item (TOCI) element
            Aspose.Pdf.LogicalStructure.TOCIElement toci = content.CreateTOCIElement();
    
            // Add the TOCI element to the TOC element
            tocElement.AppendChild(toci);
    
            // Add an entry to the TOC page and link it to the TOCI element
            header.AddEntryToTocPage(tocPage, toci);
    
            // Add a logical reference to the header within the TOCI element
            toci.AddRef(header);
    
            // Save PDF document
            doc.Save(dataDir + "CreatePdfWithTOCpage_out.pdf");
        }
    }

.NET 8

    // For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
    private static void CreatePdfWithTOCpage()
    {
        // The path to the documents directory
        var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();
    
        // Create PDF document
        using var doc = new Aspose.Pdf.Document();
        
        // Get tagged content for the PDF structure
        Aspose.Pdf.Tagged.ITaggedContent content = doc.TaggedContent;
        Aspose.Pdf.LogicalStructure.StructureElement rootElement = content.RootElement;
        content.SetLanguage("en-US");
    
        // Add the table of contents (TOC) page
        Aspose.Pdf.Page tocPage = doc.Pages.Add();
        tocPage.TocInfo = new Aspose.Pdf.TocInfo();
    
        // Create a TOC structure element
        Aspose.Pdf.LogicalStructure.TOCElement tocElement = content.CreateTOCElement();
    
        // Add the TOC element to the document structure tree
        rootElement.AppendChild(tocElement);
    
        // Add a content page
        doc.Pages.Add();
    
        // Create a header element and set its text
        Aspose.Pdf.LogicalStructure.HeaderElement header = content.CreateHeaderElement(1);
        header.SetText("1. Header");
    
        // Add the header to the document structure
        rootElement.AppendChild(header);
    
        // Create a TOC item (TOCI) element
        Aspose.Pdf.LogicalStructure.TOCIElement toci = content.CreateTOCIElement();
    
        // Add the TOCI element to the TOC element
        tocElement.AppendChild(toci);
    
        // Add an entry to the TOC page and link it to the TOCI element
        header.AddEntryToTocPage(tocPage, toci);
    
        // Add a logical reference to the header within the TOCI element
        toci.AddRef(header);
    
        // Save PDF document
        doc.Save(dataDir + "CreatePdfWithTOCpage_out.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 CreatePdfWithTOCpageAdvanced()
    {
        // The path to the documents directory
        var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();
    
        // Create PDF document
        using (var doc = new Aspose.Pdf.Document())
        {
            // Get tagged content for the PDF structure
            Aspose.Pdf.Tagged.ITaggedContent content = doc.TaggedContent;
            Aspose.Pdf.LogicalStructure.StructureElement rootElement = content.RootElement;
            content.SetLanguage("en-US");
    
            // Add the table of contents (TOC) page
            Aspose.Pdf.Page tocPage = doc.Pages.Add();
            tocPage.TocInfo = new Aspose.Pdf.TocInfo();
            tocPage.TocInfo.Title = new Aspose.Pdf.Text.TextFragment("Table of Contents");
    
            // Create a TOC structure element
            Aspose.Pdf.LogicalStructure.TOCElement tocElement = content.CreateTOCElement();
    
            // Create a header element for the TOC page title
            Aspose.Pdf.LogicalStructure.HeaderElement headerForTOCpageTitle = content.CreateHeaderElement(1);
            tocElement.LinkTocPageTitleToHeaderElement(tocPage, headerForTOCpageTitle);
    
            // Add the TOC page title header and TOC element to the document structure tree
            rootElement.AppendChild(headerForTOCpageTitle);
            rootElement.AppendChild(tocElement);
    
            // Add a content page
            doc.Pages.Add();
    
            // Create a header element and set its text
            Aspose.Pdf.LogicalStructure.HeaderElement header = content.CreateHeaderElement(1);
            header.SetText("1. Header");
    
            // Add the header to the document structure
            rootElement.AppendChild(header);
    
            // Create a TOC item (TOCI) element
            Aspose.Pdf.LogicalStructure.TOCIElement toci = content.CreateTOCIElement();
    
            // Add the TOCI element to the TOC element
            tocElement.AppendChild(toci);
    
            // Add an entry to the TOC page and link it to the TOCI element
            header.AddEntryToTocPage(tocPage, toci);
    
            // Add a logical reference to the header within the TOCI element
            toci.AddRef(header);
    
            // Create a list element for TOCI subitems
            Aspose.Pdf.LogicalStructure.ListElement listElement = content.CreateListElement();
            for (var i = 1; i <= 3; i++)
            {
                // Create a list item (LI) element
                Aspose.Pdf.LogicalStructure.ListLIElement li = content.CreateListLIElement();
    
                // Add the list item to the list element
                listElement.AppendChild(li);
    
                // Create a sub-header element and set its properties
                Aspose.Pdf.LogicalStructure.HeaderElement subHeader = content.CreateHeaderElement(2);
                subHeader.StructureTextState.FontSize = 14;
                subHeader.Language = "en-US";
                subHeader.SetText($@"1.{i} subheader ");
    
                // Add an entry to the TOC page and link it to the LI element
                subHeader.AddEntryToTocPage(tocPage, li);
    
                // Add a logical reference to the subheader element
                li.AddRef(subHeader);
    
                // Create a paragraph element and set its text and language
                Aspose.Pdf.LogicalStructure.ParagraphElement p = content.CreateParagraphElement();
                p.SetText("Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.");
                p.Language = "en-US";
    
                // Add the sub-header and paragraph to the document structure
                rootElement.AppendChild(subHeader);
                rootElement.AppendChild(p);
            }
    
            // Add the list element as a child to the TOCI element
            toci.AppendChild(listElement);
    
            // --- Additional TOC header example ---
            // Create a second header element (see comments above for header 1)
            Aspose.Pdf.LogicalStructure.HeaderElement header2 = content.CreateHeaderElement(1);
            header2.SetText("2. Header");
            rootElement.AppendChild(header2);
    
            Aspose.Pdf.LogicalStructure.TOCIElement toci2 = content.CreateTOCIElement();
            tocElement.AppendChild(toci2);
    
            header2.AddEntryToTocPage(tocPage, toci2);
            toci2.AddRef(header2);
    
            // Save the PDF document
            doc.Save(dataDir + "CreatePdfWithTOCpageAdvanced_out.pdf");
        }
    }

.NET 8

    // For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
    private static void CreatePdfWithTOCpageAdvanced()
    {
        // The path to the documents directory
        var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();
    
        // Create PDF document
        using var doc = new Aspose.Pdf.Document();
        
        // Get tagged content for the PDF structure
        Aspose.Pdf.Tagged.ITaggedContent content = doc.TaggedContent;
        Aspose.Pdf.LogicalStructure.StructureElement rootElement = content.RootElement;
        content.SetLanguage("en-US");
    
        // Add the table of contents (TOC) page
        Aspose.Pdf.Page tocPage = doc.Pages.Add();
        tocPage.TocInfo = new Aspose.Pdf.TocInfo();
        tocPage.TocInfo.Title = new Aspose.Pdf.Text.TextFragment("Table of Contents");
    
        // Create a TOC structure element
        Aspose.Pdf.LogicalStructure.TOCElement tocElement = content.CreateTOCElement();
    
        // Create a header element for the TOC page title
        Aspose.Pdf.LogicalStructure.HeaderElement headerForTOCpageTitle = content.CreateHeaderElement(1);
        tocElement.LinkTocPageTitleToHeaderElement(tocPage, headerForTOCpageTitle);
    
        // Add the TOC page title header and TOC element to the document structure tree
        rootElement.AppendChild(headerForTOCpageTitle);
        rootElement.AppendChild(tocElement);
    
        // Add a content page
        doc.Pages.Add();
    
        // Create a header element and set its text
        Aspose.Pdf.LogicalStructure.HeaderElement header = content.CreateHeaderElement(1);
        header.SetText("1. Header");
    
        // Add the header to the document structure
        rootElement.AppendChild(header);
    
        // Create a TOC item (TOCI) element
        Aspose.Pdf.LogicalStructure.TOCIElement toci = content.CreateTOCIElement();
    
        // Add the TOCI element to the TOC element
        tocElement.AppendChild(toci);
    
        // Add an entry to the TOC page and link it to the TOCI element
        header.AddEntryToTocPage(tocPage, toci);
    
        // Add a logical reference to the header within the TOCI element
        toci.AddRef(header);
    
        // Create a list element for TOCI subitems
        Aspose.Pdf.LogicalStructure.ListElement listElement = content.CreateListElement();
        for (var i = 1; i <= 3; i++)
        {
            // Create a list item (LI) element
            Aspose.Pdf.LogicalStructure.ListLIElement li = content.CreateListLIElement();
    
            // Add the list item to the list element
            listElement.AppendChild(li);
    
            // Create a sub-header element and set its properties
            Aspose.Pdf.LogicalStructure.HeaderElement subHeader = content.CreateHeaderElement(2);
            subHeader.StructureTextState.FontSize = 14;
            subHeader.Language = "en-US";
            subHeader.SetText($@"1.{i} subheader ");
    
            // Add an entry to the TOC page and link it to the LI element
            subHeader.AddEntryToTocPage(tocPage, li);
    
            // Add a logical reference to the subheader element
            li.AddRef(subHeader);
    
            // Create a paragraph element and set its text and language
            Aspose.Pdf.LogicalStructure.ParagraphElement p = content.CreateParagraphElement();
            p.SetText("Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.");
            p.Language = "en-US";
    
            // Add the sub-header and paragraph to the document structure
            rootElement.AppendChild(subHeader);
            rootElement.AppendChild(p);
        }
    
        // Add the list element as a child to the TOCI element
        toci.AppendChild(listElement);
    
        // --- Additional TOC header example ---
        // Create a second header element (see comments above for header 1)
        Aspose.Pdf.LogicalStructure.HeaderElement header2 = content.CreateHeaderElement(1);
        header2.SetText("2. Header");
        rootElement.AppendChild(header2);
    
        Aspose.Pdf.LogicalStructure.TOCIElement toci2 = content.CreateTOCIElement();
        tocElement.AppendChild(toci2);
    
        header2.AddEntryToTocPage(tocPage, toci2);
        toci2.AddRef(header2);
    
        // Save the PDF document
        doc.Save(dataDir + "CreatePdfWithTOCpageAdvanced_out.pdf");
    }