PdfSaveOptions

PdfSaveOptions class

Может использоваться для указания дополнительных параметров при сохранении документа вPdf формат.

Чтобы узнать больше, посетитеУкажите параметры сохранения статья документации.

public class PdfSaveOptions : FixedPageSaveOptions

Конструкторы

ИмяОписание
PdfSaveOptions()Инициализирует новый экземпляр этого класса, который можно использовать для сохранения документа в .Pdf формат.

Характеристики

ИмяОписание
AdditionalTextPositioning { get; set; }Флаг, определяющий, писать ли дополнительные операторы позиционирования текста или нет.
AllowEmbeddingPostScriptFonts { get; set; }Получает или задает логическое значение, указывающее, разрешено ли встраивание шрифтов PostScript в контуры PostScript при встраивании шрифтов TrueType в документ после его сохранения. Значение по умолчанию:ЛОЖЬ .
CacheBackgroundGraphics { get; set; }Получает или задает значение, определяющее, следует ли кэшировать графику, размещенную в фоновом режиме документа.
ColorMode { get; set; }Получает или задает значение, определяющее способ отображения цветов.
Compliance { get; set; }Указывает уровень соответствия стандартам PDF для выходных документов.
CreateNoteHyperlinks { get; set; }Указывает, следует ли преобразовывать ссылки на сноски/концевые сноски в основном тексте в активные гиперссылки. При нажатии гиперссылка приведет к соответствующей сноске/концевой сноске. Значение по умолчанию:ЛОЖЬ .
CustomPropertiesExport { get; set; }Получает или устанавливает значение, определяющее способCustomDocumentProperties экспортируются в файл PDF.
CustomTimeZoneInfo { get; set; }Получает или задает пользовательский часовой пояс, используемый для полей даты и времени.
DefaultTemplate { get; set; }Получает или задает путь к шаблону по умолчанию (включая имя файла). Значение по умолчанию для этого свойства:пустая строка (Empty).
DigitalSignatureDetails { get; set; }Получает или задает данные для подписи выходного PDF-документа.
DisplayDocTitle { get; set; }Флаг, указывающий, должен ли заголовок окна отображать заголовок документа, взятый из записи заголовка словаря информации о документе.
Dml3DEffectsRenderingMode { get; set; }Получает или задает значение, определяющее способ визуализации 3D-эффектов.
override DmlEffectsRenderingMode { get; set; }Получает или задает значение, определяющее способ визуализации эффектов DrawingML.
DmlRenderingMode { get; set; }Получает или задает значение, определяющее способ отрисовки фигур DrawingML.
DownsampleOptions { get; set; }Позволяет указать параметры понижения разрешения.
EmbedAttachments { get; set; }Получает или задает значение, определяющее, следует ли встраивать вложения в PDF-документ.
EmbedFullFonts { get; set; }Управляет тем, как шрифты внедряются в результирующие PDF-документы.
EncryptionDetails { get; set; }Получает или задает сведения для шифрования выходного PDF-документа.
ExportDocumentStructure { get; set; }Получает или задает значение, определяющее, следует ли экспортировать структуру документа.
ExportGeneratorName { get; set; }Когдаистинный , приводит к внедрению имени и версии Aspose.Words в создаваемые файлы. Значение по умолчанию:истинный .
ExportLanguageToSpanTag { get; set; }Получает или задает значение, определяющее, следует ли создавать тег «Span» в структуре документа для экспорта текстового языка.
ExportParagraphGraphicsToArtifact { get; set; }Получает или задает значение, определяющее, следует ли помечать изображение абзаца как артефакт.
FontEmbeddingMode { get; set; }Определяет режим внедрения шрифта.
HeaderFooterBookmarksExportMode { get; set; }Определяет, как экспортируются закладки в верхних и нижних колонтитулах.
ImageColorSpaceExportMode { get; set; }Указывает, как цветовое пространство будет выбрано для изображений в PDF-документе.
ImageCompression { get; set; }Указывает тип сжатия, который будет использоваться для всех изображений в документе.
ImlRenderingMode { get; set; }Получает или задает значение, определяющее способ визуализации объектов рукописного ввода (InkML).
InterpolateImages { get; set; }Флаг, указывающий, должна ли интерполяция изображения выполняться соответствующим считывателем. КогдаЛОЖЬ указан, флаг не записывается в выходной документ и вместо него используется поведение чтения по умолчанию.
JpegQuality { get; set; }Получает или задает значение, определяющее качество изображений JPEG в документе PDF.
MemoryOptimization { get; set; }Получает или задает значение, определяющее, следует ли выполнять оптимизацию памяти перед сохранением документа. Значение по умолчанию для этого свойства:ЛОЖЬ .
MetafileRenderingOptions { get; set; }Позволяет указать параметры рендеринга метафайла.
NumeralFormat { get; set; }Получает или устанавливаетNumeralFormat используется для отрисовки цифр. По умолчанию используются европейские цифры.
OpenHyperlinksInNewWindow { get; set; }Получает или задает значение, определяющее, будут ли гиперссылки в выходном PDF-документе document принудительно открываться в новом окне (или вкладке) браузера.
virtual OptimizeOutput { get; set; }Флаг указывает, требуется ли оптимизировать вывод. Если этот флаг установлен, избыточные вложенные холсты и пустые холсты удаляются, также объединяются соседние глифы с одинаковым форматированием. Примечание. На точность отображения содержимого может повлиять, если для этого свойства установлено значениеистинный . По умолчанию:ЛОЖЬ .
OutlineOptions { get; }Позволяет указать параметры контура.
PageMode { get; set; }Указывает, как PDF-документ должен отображаться при открытии в программе чтения PDF.
PageSavingCallback { get; set; }Позволяет контролировать сохранение отдельных страниц при экспорте документа в фиксированный формат страницы.
PageSet { get; set; }Получает или задает страницы для рендеринга. По умолчанию — все страницы в документе.
PreblendImages { get; set; }Получает или задает значение, определяющее, следует ли предварительно смешивать прозрачные изображения с черным цветом фона.
PreserveFormFields { get; set; }Указывает, следует ли сохранять поля формы Microsoft Word как поля формы в PDF или преобразовывать их в текст. Значение по умолчанию:ЛОЖЬ .
PrettyFormat { get; set; }Когдаистинный вывод в красивых форматах, где это применимо. Значение по умолчанию:ЛОЖЬ .
ProgressCallback { get; set; }Вызывается при сохранении документа и принимает данные о ходе сохранения.
override SaveFormat { get; set; }Указывает формат, в котором документ будет сохранен, если используется этот объект параметров сохранения. Может быть толькоPdf .
TempFolder { get; set; }Указывает папку для временных файлов, используемых при сохранении в файл DOC или DOCX. По умолчанию это свойство имеет значениенулевой и никакие временные файлы не используются.
TextCompression { get; set; }Указывает тип сжатия, который будет использоваться для всего текстового содержимого в документе.
UpdateCreatedTimeProperty { get; set; }Получает или задает значение, определяющее, будет лиCreatedTime свойство обновляется перед сохранением. Значение по умолчанию:ЛОЖЬ ;
UpdateFields { get; set; }Получает или задает значение, определяющее, следует ли обновлять поля определенных типов перед сохранением документа в фиксированном формате страницы. Значение по умолчанию для этого свойства:истинный .
UpdateLastPrintedProperty { get; set; }Получает или задает значение, определяющее, будет лиLastPrinted свойство обновляется перед сохранением.
UpdateLastSavedTimeProperty { get; set; }Получает или задает значение, определяющее, будет лиLastSavedTime свойство обновляется перед сохранением.
UseAntiAliasing { get; set; }Получает или задает значение, определяющее, использовать ли сглаживание для рендеринга.
UseBookFoldPrintingSettings { get; set; }Получает или задает логическое значение, указывающее, следует ли сохранять документ с использованием макета для печати буклета, , если оно указано черезMultiplePages .
UseCoreFonts { get; set; }Получает или задает значение, определяющее, следует ли заменять шрифты TrueType Arial, Times New Roman, Courier New и символ базовыми шрифтами PDF Type 1.
UseHighQualityRendering { get; set; }Получает или задает значение, определяющее, следует ли использовать алгоритмы высококачественного (т. е. медленного) рендеринга.
ZoomBehavior { get; set; }Получает или задает значение, определяющее, какой тип масштабирования следует применять при открытии документа с помощью средства просмотра PDF.
ZoomFactor { get; set; }Получает или задает значение, определяющее коэффициент масштабирования (в процентах) для документа.

Методы

ИмяОписание
Clone()Создает глубокую копию этого объекта.
override Equals(object)Определяет, равен ли указанный объект по значению текущему объекту.

Примеры

Показывает, как изменить цвет изображения с сохранением свойства параметров.

Document doc = new Document(MyDir + "Images.docx");

// Создаем объект «PdfSaveOptions», который мы можем передать методу «Save» документа.
// чтобы изменить способ преобразования этого метода в .PDF.
// Установите для свойства «ColorMode» значение «Оттенки серого», чтобы отобразить все изображения из документа в черно-белом режиме.
// Размер выходного документа может быть больше с этой настройкой.
// Установите для свойства ColorMode значение «Normal», чтобы отобразить все изображения в цвете.
PdfSaveOptions pdfSaveOptions = new PdfSaveOptions { ColorMode = colorMode };

doc.Save(ArtifactsDir + "PdfSaveOptions.ColorRendering.pdf", pdfSaveOptions);

Показывает, как применить сжатие текста при сохранении документа в формате PDF.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

for (int i = 0; i < 100; i++)
    builder.Writeln("Lorem ipsum dolor sit amet, consectetur adipiscing elit, " +
                    "sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.");

// Создаем объект «PdfSaveOptions», который мы можем передать методу «Save» документа.
// чтобы изменить способ преобразования этого метода в .PDF.
PdfSaveOptions options = new PdfSaveOptions();

// Установите для свойства TextCompression значение «PdfTextCompression.None», чтобы не применять какие-либо
// сжатие в текст при сохранении документа в PDF.
// Установите для свойства TextCompression значение «PdfTextCompression.Flate», чтобы применить сжатие ZIP.
// в текст, когда мы сохраняем документ в PDF. Чем больше документ, тем большее влияние он окажет.
options.TextCompression = pdfTextCompression;

doc.Save(ArtifactsDir + "PdfSaveOptions.TextCompression.pdf", options);

Показывает, как преобразовать весь документ в PDF с тремя уровнями структуры документа.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Вставляем заголовки уровней с 1 по 5.
builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading1;

Assert.True(builder.ParagraphFormat.IsHeading);

builder.Writeln("Heading 1");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading2;

builder.Writeln("Heading 1.1");
builder.Writeln("Heading 1.2");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading3;

builder.Writeln("Heading 1.2.1");
builder.Writeln("Heading 1.2.2");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading4;

builder.Writeln("Heading 1.2.2.1");
builder.Writeln("Heading 1.2.2.2");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading5;

builder.Writeln("Heading 1.2.2.2.1");
builder.Writeln("Heading 1.2.2.2.2");

// Создаем объект «PdfSaveOptions», который мы можем передать методу «Save» документа.
// чтобы изменить способ преобразования этого метода в .PDF.
PdfSaveOptions options = new PdfSaveOptions();

// Выходной PDF-документ будет содержать структуру, представляющую собой оглавление со списком заголовков в теле документа.
// Нажатие на запись в этом контуре приведет нас к местоположению соответствующего заголовка.
// Установите для свойства «HeadingsOutlineLevels» значение «4», чтобы исключить из структуры все заголовки, уровни которых выше 4.
options.OutlineOptions.HeadingsOutlineLevels = 4;

// Если запись структуры имеет последующие записи более высокого уровня между собой и следующей записью того же или более низкого уровня,
// слева от записи появится стрелка. Эта запись является «владельцем» нескольких таких «подзаписей».
// В нашем документе записи схемы 5-го уровня заголовка являются подзаписями второй записи структуры 4-го уровня,
// записи 4-го и 5-го уровня заголовка являются подзаписями второй записи 3-го уровня и так далее.
// В структуре мы можем щелкнуть стрелку записи «владелец», чтобы свернуть/развернуть все ее подзаписи.
// Установите для свойства "ExpandedOutlineLevels" значение "2", чтобы автоматически развернуть все заголовки уровня 2 и нижних записей структуры.
// и свернуть все записи уровня 3 и выше, когда мы открываем документ.
options.OutlineOptions.ExpandedOutlineLevels = 2;

doc.Save(ArtifactsDir + "PdfSaveOptions.ExpandedOutlineLevels.pdf", options);

Смотрите также