Имя пользовательского тега

Введение

В сегодняшнюю цифровую эпоху PDF-файлы встречаются повсеместно. От отчетов до руководств они служат множеству целей в различных отраслях. Однако обеспечение доступности этих документов для всех, включая людей с ограниченными возможностями, имеет решающее значение. Именно здесь в игру вступают тегированные PDF-файлы. Они облегчают для экранных ридеров и других вспомогательных технологий эффективную интерпретацию содержимого документа.

Предпосылки

Прежде чем мы перейдем к кодированию, важно убедиться, что у вас все готово. Вот что вам понадобится:

  1. Visual Studio — подойдет любая последняя версия, но для оптимальной функциональности лучше иметь последнюю версию.
  2. Aspose.PDF для .NET — вы можете легко загрузить последнюю версию с сайтассылка для скачивания.
  3. Базовые знания C#. Знакомство с основами программирования на C# будет полезным при реализации кода.

Импортные пакеты

После настройки среды следующим шагом будет импорт необходимых пакетов для использования Aspose.PDF. Это можно сделать, добавив библиотеку Aspose.PDF в свой проект.

Установить Aspose.PDF через NuGet

  1. Откройте проект Visual Studio: если вы еще не создали проект, создайте новый.
  2. Откройте диспетчер пакетов NuGet: щелкните правой кнопкой мыши свой проект в обозревателе решений и выберите «Управление пакетами NuGet».
  3. Поиск Aspose.PDF: введите «Aspose.PDF» в строке поиска.
  4. Установите пакет: Нажмите «Установить», чтобы добавить пакет в свой проект. После установки все готово!

Добавить директиву using

Чтобы использовать функциональность Aspose в своем коде, вам необходимо добавить необходимую директиву using в начало вашего файла:

using Aspose.Pdf.LogicalStructure;
using Aspose.Pdf.Tagged;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

Выполнив эти шаги, вы готовы приступить к созданию вашего тегированного PDF-файла!

Теперь, когда у вас все настроено, давайте погрузимся в основную задачу: создание тегированного PDF-документа. Вот пошаговое руководство о том, как это сделать с помощью Aspose.PDF для .NET.

Шаг 1: Определите каталог документов

Во-первых, вам нужно указать путь, по которому будет сохранен ваш PDF-файл. Здесь вы определите свой каталог данных.

string dataDir = "YOUR DOCUMENT DIRECTORY";

Объяснение: Замените “ВАША КАТАЛОГА ДОКУМЕНТОВ” на фактический путь, по которому вы хотите сохранить файл PDF. Крайне важно иметь разрешение на запись в этом каталоге, чтобы избежать исключений во время выполнения.

Шаг 2: Создайте новый PDF-документ

Далее мы создадим экземплярDocument сорт.

Document document = new Document();

Объяснение: Эта строка инициализирует новый документ PDF. Думайте об этом как о создании чистого холста, на котором вы будете рисовать содержимое вашего PDF.

Шаг 3: Создайте тегированный контент

Теперь пришло время перейти к сути тегирования. Мы извлечем тегированное содержимое документа.

ITaggedContent taggedContent = document.TaggedContent;

Объяснение:TaggedContent Объект позволяет нам манипулировать логической структурой и доступностью PDF-файла, организуя его содержимое иерархически.

Шаг 4: Установите название и язык

Далее вы можете задать заголовок документа и атрибут языка. Это поможет программам чтения с экрана правильно обработать документ.

taggedContent.SetTitle("Tagged Pdf Document");
taggedContent.SetLanguage("en-US");

Пояснение: Здесь мы информируем всех, кто читает этот PDF-файл, о его названии и языке, что облегчает понимание, особенно в отношении инструментов доступности.

Шаг 5: Создание элементов логической структуры

Теперь пришло время создать структурированные элементы в вашем PDF-файле.

SectElement sect = taggedContent.CreateSectElement();
taggedContent.RootElement.AppendChild(sect);

Пояснение: Этот шаг вводит элемент раздела, где вы можете начать добавлять контент.RootElement это ваш дом.

Шаг 6: Создание элементов абзаца

Теперь мы создаем различные элементы абзаца и задаем их текстовое содержимое.

ParagraphElement p1 = taggedContent.CreateParagraphElement();
ParagraphElement p2 = taggedContent.CreateParagraphElement();
ParagraphElement p3 = taggedContent.CreateParagraphElement();
ParagraphElement p4 = taggedContent.CreateParagraphElement();
p1.SetText("P1. ");
p2.SetText("P2. ");
p3.SetText("P3. ");
p4.SetText("P4. ");

Пояснение: Каждый абзац подобен предложению в рассказе, определяющему обстановку и придающему смысл вашему документу.

Шаг 7: Присвойте теги абзацам

Для обеспечения доступности вашего PDF-файла крайне важно правильно снабдить каждый абзац тегами.

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

Объяснение: Добавляя теги, мы даем вспомогательным технологиям возможность понимать структуру контента — это как будто дает им дорожную карту для навигации по территории.

Шаг 8: Добавьте абзацы в раздел

Теперь мы добавим эти абзацы в ранее созданный раздел.

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

Пояснение: Это действие организует абзацы внутри раздела, делая поток логичным и простым для понимания.

Шаг 9: Создание элементов Span

Как и абзацы, интервалы добавляют детализацию к текстовому содержимому.

SpanElement span1 = taggedContent.CreateSpanElement();
SpanElement span2 = taggedContent.CreateSpanElement();
SpanElement span3 = taggedContent.CreateSpanElement();
SpanElement span4 = taggedContent.CreateSpanElement();
span1.SetText("Span 1.");
span2.SetText("Span 2.");
span3.SetText("Span 3.");
span4.SetText("Span 4.");

Объяснение: Промежутки — это своего рода тонкая настройка деталей; они добавляют конкретики тому, что вы передаете в каждом абзаце.

Шаг 10: Назначьте теги элементам Span

Так же, как мы делали это для абзацев, нам следует пометить элементы span, чтобы облегчить понимание.

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

Пояснение: Правильная маркировка диапазонов гарантирует, что все нюансы будут точно представлены, что позволит создать насыщенный документ для любого, кто с ним столкнется.

Шаг 11: Добавьте интервалы к абзацам

Теперь давайте добавим наши элементы span к соответствующим абзацам.

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

Пояснение: Эта интеграция улучшает ваши абзацы, добавляя дополнительную информацию, подобно добавлению сносок в книгу для более глубокого понимания.

Шаг 12: Сохраните помеченный PDF-документ

Наконец, пришло время сохранить ваш шедевр!

document.Save(dataDir + "CustomTag.pdf");

Объяснение: Эта строка сохраняет ваш помеченный PDF в указанный каталог. На этом вы завершили создание вашего помеченного PDF-документа!

Заключение

Создание помеченных PDF-документов с помощью Aspose.PDF для .NET — это не просто добавление контента; это создание доступного опыта для всех пользователей. Всего за несколько шагов вы можете гарантировать, что ваши документы будут понятны всем, устраняя барьеры и улучшая понимание.

Часто задаваемые вопросы

Что такое PDF-файл с тегами?

Размеченный PDF-файл содержит дополнительные метаданные, описывающие структуру и доступность содержимого документа, что упрощает его интерпретацию с помощью вспомогательных технологий.

Зачем мне нужен Aspose.PDF для .NET?

Aspose.PDF для .NET — это мощная библиотека, которая позволяет разработчикам создавать, изменять и обрабатывать PDF-документы программным способом с помощью обширных функций.

Как получить пробную версию Aspose.PDF?

Вы можете получить бесплатную пробную версию Aspose.PDF, посетивэта ссылка.

Могу ли я получить поддержку по Aspose.PDF?

Да, вы можете обратиться за поддержкой черезфорум Aspose.

Где я могу найти подробную документацию Aspose.PDF?

Полную документацию можно найтиздесь.

Создать элемент таблицы Элементы структуры иллюстрации