DocumentBase.ExportAsFixedFormat Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Сохраняет документ в формате PDF или XPS.
public void ExportAsFixedFormat (string outputFileName, Microsoft.Office.Interop.Word.WdExportFormat exportFormat, bool openAfterExport, Microsoft.Office.Interop.Word.WdExportOptimizeFor optimizeFor, Microsoft.Office.Interop.Word.WdExportRange range, int from, int to, Microsoft.Office.Interop.Word.WdExportItem item, bool includeDocProps, bool keepIRM, Microsoft.Office.Interop.Word.WdExportCreateBookmarks createBookmarks, bool docStructureTags, bool bitmapMissingFonts, bool useISO19005_1, ref object fixedFormatExtClassPtr);
member this.ExportAsFixedFormat : string * Microsoft.Office.Interop.Word.WdExportFormat * bool * Microsoft.Office.Interop.Word.WdExportOptimizeFor * Microsoft.Office.Interop.Word.WdExportRange * int * int * Microsoft.Office.Interop.Word.WdExportItem * bool * bool * Microsoft.Office.Interop.Word.WdExportCreateBookmarks * bool * bool * bool * obj -> unit
Public Sub ExportAsFixedFormat (outputFileName As String, exportFormat As WdExportFormat, Optional openAfterExport As Boolean, Optional optimizeFor As WdExportOptimizeFor, Optional range As WdExportRange, Optional from As Integer, Optional to As Integer, Optional item As WdExportItem, Optional includeDocProps As Boolean, Optional keepIRM As Boolean, Optional createBookmarks As WdExportCreateBookmarks, Optional docStructureTags As Boolean, Optional bitmapMissingFonts As Boolean, Optional useISO19005_1 As Boolean, Optional ByRef fixedFormatExtClassPtr As Object)
Параметры
- outputFileName
- String
Полный путь и имя нового файла формата PDF или XPS.
- exportFormat
- WdExportFormat
Одно из значений WdExportFormat, указывающих, следует ли сохранять документ в формате PDF или XPS.
- openAfterExport
- Boolean
Значение true
используется, чтобы автоматически открыть новый файл; в противном случае используется значение false
.
- optimizeFor
- WdExportOptimizeFor
Одно из значений WdExportOptimizeFor, указывающих параметры оптимизации (для вывода на экран или на печать).
- range
- WdExportRange
Одно из значений WdExportRange, указывающее, относится ли к диапазону экспорта весь документ, текущая страница, текст или текущий выделенный фрагмент. По умолчанию диапазоном экспорта является весь документ.
- from
- Int32
Указывает номер начальной страницы, если Range
параметр имеет значение wdExportFromTo.
- to
- Int32
Указывает номер конечной страницы, если Range
параметр имеет значение wdExportFromTo.
- item
- WdExportItem
Одно из значений WdExportItem, указывающих, будет ли экспортироваться только текст или текст с разметкой.
- includeDocProps
- Boolean
Значение true
используется, чтобы включить свойства документа в новый файл; в противном случае используется значение false
.
- keepIRM
- Boolean
Значение true
используется для копирования в документ XPS разрешений механизма управления правами на доступ к данным (IRM), если исходный документ защищен IRM; в противном случае используется значение false
. Значение по умолчанию — true
.
- createBookmarks
- WdExportCreateBookmarks
Одно из значений WdExportCreateBookmarks, указывающих, следует ли экспортировать закладки, а также тип экспортируемых закладок.
- docStructureTags
- Boolean
Значение true
используется для включения дополнительных данных, облегчающих чтение с экрана, например сведения о потоке и логической структуре содержимого; в противном случае используется значение false
. Значение по умолчанию — true
.
- bitmapMissingFonts
- Boolean
Значение true
используется для включения точечного изображения текста; значение false
используется для ссылки на шрифт текста. Присвойте этому параметру значение true
, если лицензии на шрифты не позволяют внедрять шрифт в PDF-файл. Если присвоить этому параметру значение false
, то в случае, если на компьютере пользователя, просматривающего документ, указанный шрифт будет недоступен, вместо него будет подставлен соответствующий шрифт. Значение по умолчанию — true
.
- useISO19005_1
- Boolean
Значение true
используется, чтобы ограничить формат PDF подмножеством формата PDF, соответствующим стандарту ISO 19005-1; в противном случае используется значение false
. Если этому параметру присвоить значение true
, результирующие файлы будут более автономными, однако из-за ограничений формата могут иметь больший размер или содержать больше визуальных артефактов. Значение по умолчанию — false
.
- fixedFormatExtClassPtr
- Object
Указатель на реализацию интерфейса IMsoDocExporter
, который позволяет сохранять документ в другом фиксированном формате. Дополнительные сведения см. в разделе Extending the Office (2007) Fixed-Format Export Feature (Расширение функции экспорта в фиксированном формате Office 2007).
Примеры
В следующем примере кода текущий документ сохраняется в формате PDF с указанным именем. Так как папка не указана, PDF-файл по умолчанию сохраняется в папке "Мои документы" пользователя. Чтобы использовать этот пример, запустите его из ThisDocument
класса в проекте уровня документа.
private void SaveAsPDF()
{
this.ExportAsFixedFormat(
@"myPDFDocument",
Word.WdExportFormat.wdExportFormatPDF,
false,
Word.WdExportOptimizeFor.wdExportOptimizeForOnScreen,
Word.WdExportRange.wdExportAllDocument,
0,
0,
Word.WdExportItem.wdExportDocumentWithMarkup,
true,
true,
Word.WdExportCreateBookmarks.wdExportCreateWordBookmarks,
true,
true,
false,
ref missing);
}
Private Sub SaveAsPDF()
Me.ExportAsFixedFormat("MyPDFDocument", _
Word.WdExportFormat.wdExportFormatPDF)
End Sub
Комментарии
Сохранить файл в формате PDF или XPS из Microsoft Office Word можно только после установки надстройки, которая предоставляет эту функцию. Дополнительные сведения см. в office Online по запросу "Включить поддержку других форматов файлов, таких как PDF и XPS".
Необязательные параметры
Сведения о необязательных параметрах см. в разделе Необязательные параметры в решениях Office.