PdfOptions

PdfOptions класс

Предоставляет параметры, управляющие тем, как презентация сохраняется в формате Pdf.

public class PdfOptions : SaveOptions, IPdfOptions

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

ИмяОписание
PdfOptions()Конструктор по умолчанию.

Свойства

ИмяОписание
AccessPermissions { get; set; }Содержит набор флагов, определяющих, какие разрешения доступа должны быть предоставлены при открытии документа пользователем. Смотрите PdfAccessPermissions.
AdditionalCommonFontFamilies { get; set; }Возвращает или задает массив пользовательских названий семейств шрифтов, которые Aspose.Slides должен рассматривать как общие. Чтение/запись String[].
ApplyImageTransparent { get; set; }Применяет указанный прозрачный цвет к изображению, если true.
BestImagesCompressionRatio { get; set; }Указывает, следует ли автоматически выбирать наиболее эффективное сжатие (вместо стандартного) для каждого изображения. Если установлено в Boolean.true, для каждого изображения в презентации будет выбран наиболее подходящий алгоритм сжатия, что приведет к уменьшению размера полученного PDF-документа. Выбор лучшего коэффициента сжатия изображения требует значительных вычислительных ресурсов и дополнительной оперативной памяти, и значение по умолчанию этой опции — Boolean.false.
Compliance { get; set; }Желаемый уровень соответствия для генерируемого PDF-документа. Чтение/запись PdfCompliance.
DefaultRegularFont { get; set; }Возвращает или задает шрифт, используемый в случае, если исходный шрифт не найден. Чтение/запись String.
DrawSlidesFrame { get; set; }True, чтобы нарисовать черную рамку вокруг каждого слайда. Чтение/запись Boolean.
EmbedFullFonts { get; set; }Определяет, следует ли встраивать все символы шрифта или только используемое подмножество. Чтение/запись Boolean.
EmbedTrueTypeFontsForASCII { get; set; }Определяет, будет ли Aspose.Slides встраивать общие шрифты для текста ASCII (диапазон кодов 33..127). Шрифты для кодов символов больше 127 всегда встраиваются. Список общих шрифтов включает базовые 14 шрифтов PDF и дополнительные заданные пользователем шрифты. Чтение/запись Boolean.
GradientStyle { get; set; }Возвращает или задает визуальный стиль градиента. Чтение/запись GradientStyle.
ImageTransparentColor { get; set; }Получает или задает прозрачный цвет изображения.
IncludeOleData { get; set; }True, чтобы преобразовать все OLE-данные из презентации во встраиваемые файлы в результирующем PDF. Чтение/запись Boolean.
InkOptions { get; }Предоставляет параметры, контролирующие внешний вид объектов Ink в экспортируемом документе. Только чтение IInkOptions
JpegQuality { get; set; }Возвращает или задает значение, определяющее качество JPEG-изображений внутри PDF-документа. Чтение/запись Byte.
Password { get; set; }Установка пароля пользователя для защиты PDF-документа. Чтение/запись String.
ProgressCallback { get; set; }Представляет объект обратного вызова для обновлений прогресса сохранения в процентах. Смотрите IProgressCallback.
RasterizeUnsupportedFontStyles { get; set; }Указывает, следует ли растеризовать текст как bitmap и сохранить в PDF, когда шрифт не поддерживает полужирное начертание. Этот подход может улучшить качество текста в получаемом PDF для некоторых шрифтов. Чтение/запись Boolean.
SaveMetafilesAsPng { get; set; }True, чтобы преобразовать все метафайлы, используемые в презентации, в изображения PNG. Чтение/запись Boolean.
ShowHiddenSlides { get; set; }Указывает, следует ли включать скрытые слайды в генерируемый документ. По умолчанию false.
SkipJavaScriptLinks { get; set; }Указывает, следует ли пропускать гиперссылки с вызовами JavaScript при сохранении презентации. Чтение/запись Boolean. Значение по умолчанию — false.
SlidesLayoutOptions { get; set; }Получает или задает режим размещения слайдов на странице при экспорте презентации ISlidesLayoutOptions.
SufficientResolution { get; set; }Возвращает или задает значение, определяющее разрешение изображений внутри PDF-документа.
TextCompression { get; set; }Указывает тип сжатия, используемый для всего текстового содержимого документа. Чтение/запись PdfTextCompression.
WarningCallback { get; set; }Возвращает или задает объект, который получает предупреждения и решает, будет ли процесс загрузки продолжен или прерван. Чтение/запись IWarningCallback.

Примеры

Следующий пример показывает, как конвертировать PowerPoint в PDF с пользовательскими параметрами.

[C#]
using (Presentation presentation = new Presentation("PowerPoint.pptx"))
{
	// Создает экземпляр класса PdfOptions
	PdfOptions pdfOptions = new PdfOptions();
	// Устанавливает качество JPEG
	pdfOptions.JpegQuality = 90;
	// Устанавливает поведение для метафайлов
	pdfOptions.SaveMetafilesAsPng = true;
	// Устанавливает уровень сжатия текста
	pdfOptions.TextCompression = PdfTextCompression.Flate;
	// Определяет стандарт PDF
	pdfOptions.Compliance = PdfCompliance.Pdf15;
	// Сохраняет презентацию в PDF
	presentation.Save("PowerPoint-to-PDF.pdf", SaveFormat.Pdf, pdfOptions);
}

Следующий пример показывает, как конвертировать PowerPoint в PDF с скрытыми слайдами.

[C#]
// Создает экземпляр класса Presentation, представляющего файл PowerPoint
using (Presentation presentation = new Presentation("PowerPoint.pptx"))
{
	// Создает экземпляр класса PdfOptions
	PdfOptions pdfOptions = new PdfOptions();
	// Добавляет скрытые слайды
	pdfOptions.ShowHiddenSlides = true;
	// Сохраняет презентацию в PDF
	presentation.Save("PowerPoint-to-PDF.pdf", SaveFormat.Pdf, pdfOptions);
}

Следующий пример показывает, как конвертировать PowerPoint в защищенный паролем PDF.

[C#]
// Создает объект Presentation, представляющий файл PowerPoint
using (Presentation presentation = new Presentation("PowerPoint.pptx"))
{
	/// Создает экземпляр класса PdfOptions
	PdfOptions pdfOptions = new PdfOptions();
	// Устанавливает пароль PDF и разрешения доступа
	pdfOptions.Password = "password";
	pdfOptions.AccessPermissions = PdfAccessPermissions.PrintDocument | PdfAccessPermissions.HighQualityPrint;
	// Сохраняет презентацию в PDF
	presentation.Save("PPTX-to-PDF.pdf", SaveFormat.Pdf, pdfOptions);
}

Следующий пример показывает, как конвертировать PowerPoint в PDF с заметками.

[C#]
// Создает объект Presentation, представляющий файл презентации
using (Presentation presentation = new Presentation("SelectedSlides.pptx"))
{
	using (Presentation auxPresentation = new Presentation())
	{
		ISlide slide = presentation.Slides[0];
		auxPresentation.Slides.InsertClone(0, slide);
		// Установка типа и размера слайда
		//auxPresentation.SlideSize.SetSize(presentation.SlideSize.Size.Width, presentation.SlideSize.Size.Height,SlideSizeScaleType.EnsureFit);
		auxPresentation.SlideSize.SetSize(612F, 792F, SlideSizeScaleType.EnsureFit);
		PdfOptions pdfOptions = new PdfOptions();
		pdfOptions.SlidesLayoutOptions = new NotesCommentsLayoutingOptions() { NotesPosition = NotesPositions.BottomFull };
		auxPresentation.Save("PDFnotes_out.pdf", SaveFormat.Pdf, pdfOptions);
	}
}

См. также