Установить свойство выноски в PDF-файле

Aspose.PDF для .NET — это мощная библиотека для создания, управления и преобразования PDF-документов на C#. Одной из функций, предоставляемых этой библиотекой, является возможность устанавливать свойства выносок для произвольных текстовых аннотаций в документах PDF. Это можно сделать с помощьюFreeTextAnnotation класс, который позволяет создавать аннотации с выносками.

В этом руководстве мы проведем вас через процесс настройки свойств выноски для произвольной текстовой аннотации с использованием Aspose.PDF для .NET на C#. Чтобы начать, выполните следующие действия.

Установите Aspose.PDF для .NET

Если вы еще этого не сделали, вам нужно будетскачать и установите Aspose.PDF для .NET из выпусков Aspose или через менеджер пакетов NuGet.

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

Создайте новый PDF-документ, используяDocumentкласс, предоставленный Aspose.PDF для .NET.

// Путь к каталогу документов.
string dataDir = "YOUR DOCUMENT DIRECTORY";
Document doc = new Document();

Шаг 2. Добавьте в документ новую страницу.

Добавьте новую страницу в документ с помощьюPages коллекцияDocument сорт.

Page page = doc.Pages.Add();

Шаг 3. Установите внешний вид по умолчанию

Установите внешний вид по умолчанию для произвольной текстовой аннотации, создав новыйDefaultAppearance объект и установка его свойств, таких какTextColor иFontSize.

DefaultAppearance da = new DefaultAppearance();
da.TextColor = System.Drawing.Color.Red;
da.FontSize = 10;

Шаг 4. Создайте произвольную текстовую аннотацию с выноской.

Создайте новую произвольную текстовую аннотацию с выноской, используяFreeTextAnnotation сорт. УстановитьIntent собственностьFreeTextIntent.FreeTextCallout чтобы указать, что это аннотация выноски. УстановитьEndingStyle собственностьLineEnding.OpenArrow чтобы указать стиль стрелки в конце выноски. УстановитьCallout свойство массивуPoint объекты, представляющие точки на странице, где должна быть нарисована линия выноски.

FreeTextAnnotation fta = new FreeTextAnnotation(page, new Rectangle(422.25, 645.75, 583.5, 702.75), da);
fta.Intent = FreeTextIntent.FreeTextCallout;
fta.EndingStyle = LineEnding.OpenArrow;
fta.Callout = new Point[]
{
    new Point(428.25,651.75), new Point(462.75,681.375), new Point(474,681.375)
};

Шаг 5. Добавьте на страницу произвольную текстовую аннотацию.

Добавьте на страницу произвольную текстовую аннотацию с помощьюAnnotations коллекцияPage сорт.

page.Annotations.Add(fta);

Шаг 6. Добавьте текст в аннотацию

Добавьте текст в аннотацию, установивRichTextсвойство в строку форматированного XML. В этом уроке мы устанавливаем красный цвет текста и размер шрифта 9.

fta.RichText = "<body xmlns=\"http://www.w3.org/1999/xhtml\" xmlns:xfa=\"http://www.xfa.org/schema/xfa-data/1.0/\" xfa:APIVersion=\"Acrobat:11.0.23\" xfa:spec=\"2.0.2\" style=\"color:#FF

Шаг 7: сохраните документ

Теперь сохраните документ, используя следующий код:

doc.Save(dataDir + "SetCalloutProperty.pdf")

Пример исходного кода для установки свойства выноски с использованием Aspose.PDF для .NET

// Путь к каталогу документов.
string dataDir = "YOUR DOCUMENT DIRECTORY";

Document doc = new Document();
Page page = doc.Pages.Add();
DefaultAppearance da = new DefaultAppearance();
da.TextColor = System.Drawing.Color.Red;
da.FontSize = 10;
FreeTextAnnotation fta = new FreeTextAnnotation(page, new Rectangle(422.25, 645.75, 583.5, 702.75), da);
fta.Intent = FreeTextIntent.FreeTextCallout;
fta.EndingStyle = LineEnding.OpenArrow;
fta.Callout = new Point[]
{
	new Point(428.25,651.75), new Point(462.75,681.375), new Point(474,681.375)
};
page.Annotations.Add(fta);
fta.RichText = "<body xmlns=\"http://www.w3.org/1999/xhtml\" xmlns:xfa=\"http://www.xfa.org/schema/xfa-data/1.0/\" xfa:APIVersion=\"Acrobat:11.0.23\" xfa:spec=\"2.0.2\" style=\"color:#FF0000;font-weight:normal;font-style:normal;font-stretch:normal\"><p dir=\"ltr\"> <span style=\"font-size:9.0pt;font-family:Helvetica\">Это образец</span></p></body>";
doc.Save(dataDir + "SetCalloutProperty.pdf");

Заключение

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

Часто задаваемые вопросы по настройке свойства выноски в файле PDF

Вопрос: Что такое аннотация выноски в PDF-документе?

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

Вопрос: Могу ли я настроить внешний вид аннотации выноски с помощью Aspose.PDF для .NET?

О: Да, вы можете настроить различные свойства аннотации выноски, такие как цвет, размер шрифта, выравнивание текста, стиль линии, стиль стрелки и т. д.

Вопрос: Как добавить текст в аннотацию выноски?

О: Чтобы добавить текст в аннотацию выноски, вы можете установитьRichText собственностьFreeTextAnnotation объект.RichText Свойство принимает строку форматированного XML, которая представляет текст, отображаемый в аннотации выноски.

Вопрос: Могу ли я добавить несколько аннотаций к PDF-документу с помощью Aspose.PDF для .NET?

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