Установить свойство выноски в 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
объект и добавление их на разные страницы или места в документе.