Skip to content

Commit 41157b0

Browse files
lindalu-MSFTlindalu-MSFT
authored
Merge pull request #1911 from shivanshu3/main
Create Word.Document.ExportAsFixedFormat3.md
2 parents 068abce + a4029ae commit 41157b0

7 files changed

+191
-0
lines changed

‎api/TOC.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29244,6 +29244,7 @@
2924429244
###### [EndReview](Word.Document.EndReview.md)
2924529245
###### [ExportAsFixedFormat](Word.Document.ExportAsFixedFormat.md)
2924629246
###### [ExportAsFixedFormat2](Word.Document.ExportAsFixedFormat2.md)
29247+
###### [ExportAsFixedFormat3](Word.Document.ExportAsFixedFormat3.md)
2924729248
###### [FitToPages](Word.Document.FitToPages.md)
2924829249
###### [FollowHyperlink](Word.Document.FollowHyperlink.md)
2924929250
###### [FreezeLayout](Word.Document.FreezeLayout.md)
@@ -32182,6 +32183,7 @@
3218232183
###### [Expand](Word.Range.Expand.md)
3218332184
###### [ExportAsFixedFormat](Word.Range.ExportAsFixedFormat.md)
3218432185
###### [ExportAsFixedFormat2](Word.Range.ExportAsFixedFormat2.md)
32186+
###### [ExportAsFixedFormat3](Word.Range.ExportAsFixedFormat3.md)
3218532187
###### [ExportFragment](Word.Range.ExportFragment.md)
3218632188
###### [GetSpellingSuggestions](Word.Range.GetSpellingSuggestions.md)
3218732189
###### [GoTo](Word.Range.GoTo.md)
@@ -32614,6 +32616,7 @@
3261432616
###### [Expand](Word.Selection.Expand.md)
3261532617
###### [ExportAsFixedFormat](Word.Selection.ExportAsFixedFormat.md)
3261632618
###### [ExportAsFixedFormat2](Word.Selection.ExportAsFixedFormat2.md)
32619+
###### [ExportAsFixedFormat3](Word.Selection.ExportAsFixedFormat3.md)
3261732620
###### [Extend](Word.Selection.Extend.md)
3261832621
###### [GoTo](Word.Selection.GoTo.md)
3261932622
###### [GoToEditableRange](Word.Selection.GoToEditableRange.md)

‎api/Word.Document.ExportAsFixedFormat3.md

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
---
2+
title: Document.ExportAsFixedFormat3 method (Word)
3+
keywords: vbawd10.chm158007848
4+
f1_keywords:
5+
- vbawd10.chm158007848
6+
api_name:
7+
- Word.Document.ExportAsFixedFormat3
8+
ms.assetid: fe248ff2-0a2a-b10e-fed9-d5bfb73ff1b2
9+
ms.date: 03/26/2025
10+
ms.localizationpriority: medium
11+
---
12+
13+
# Document.ExportAsFixedFormat3 method (Word)
14+
15+
Saves a document in PDF or XPS format.
16+
17+
## Syntax
18+
19+
_expression_.**ExportAsFixedFormat3** (_OutputFileName_, _ExportFormat_, _OpenAfterExport_, _OptimizeFor_, _Range_, _From_, _To_, _Item_, _IncludeDocProps_, _KeepIRM_, _CreateBookmarks_, _DocStructureTags_, _BitmapMissingFonts_, _UseISO19005\_1_, _OptimizeForImageQuality_, _ImproveExportTagging_, _FixedFormatExtClassPtr_)
20+
21+
_expression_ An expression that returns a **[Document](Word.Document.md)** object.
22+
23+
24+
## Parameters
25+
26+
|Name|Required/Optional|Data type|Description|
27+
|:-----|:-----|:-----|:-----|
28+
| _OutputFileName_|Required| **String**|The path and file name of the new PDF or XPS file.|
29+
| _ExportFormat_|Required| **[WdExportFormat](Word.WdExportFormat.md)**|Specifies either PDF or XPS format.|
30+
| _OpenAfterExport_|Optional| **Boolean**|Opens the new file after exporting the contents.|
31+
| _OptimizeFor_|Optional| **[WdExportOptimizeFor](Word.WdExportOptimizeFor.md)**|Specifies whether to optimize for screen or print.|
32+
| _Range_|Optional| **[WdExportRange](Word.WdExportRange.md)**|Specifies whether the export range is the entire document, the current page, a range of text, or the current selection. The default is to export the entire document.|
33+
| _From_|Optional| **Long**|Specifies the starting page number, if the _Range_ parameter is set to **wdExportFromTo**.|
34+
| _To_|Optional| **Long**|Specifies the ending page number, if the _Range_ parameter is set to **wdExportFromTo**.|
35+
| _Item_|Optional| **[WdExportItem](Word.WdExportItem.md)**|Specifies whether the export process includes text only or includes text with markup.|
36+
| _IncludeDocProps_|Optional| **Boolean**|Specifies whether to include document properties in the newly exported file.|
37+
| _KeepIRM_|Optional| **Boolean**|Specifies whether to copy IRM permissions to an XPS document if the source document has IRM protections.</br></br>If _ExportFormat_ is _wdExportFormatPDF_, this flag also specifies whether to copy labels to the PDF.</br></br>Default value is **True**.|
38+
| _CreateBookmarks_|Optional| **[WdExportCreateBookmarks](Word.WdExportCreateBookmarks.md)**|Specifies whether to export bookmarks and the type of bookmarks to export.|
39+
| _DocStructureTags_|Optional| **Boolean**|Specifies whether to include extra data to help screen readers, for example information about the flow and logical organization of the content. Default value is **True**.|
40+
| _BitmapMissingFonts_|Optional| **Boolean**|Specifies whether to include a bitmap of the text. Set this parameter to **True** when font licenses don't permit a font to be embedded in the PDF file. If **False**, the font is referenced, and the viewer's computer substitutes an appropriate font if the authored one is not available. Default value is **True**.|
41+
| _UseISO19005\_1_|Optional| **Boolean**|Specifies whether to limit PDF usage to the PDF subset standardized as ISO 19005-1. If **True**, the resulting files are more reliably self-contained but may be larger or show more visual artifacts due to the restrictions of the format. Default value is **False**.|
42+
| _OptimizeForImageQuality_|Optional| **Boolean**|Specifies whether to downsample images or keep their original quality. If **True**, the resulting files will have better image quality but may be larger. Default value is **False**.|
43+
| _ImproveExportTagging_|Optional| **Boolean**|Specifies whether to enable improved accessbility tagging. For more information, see the Remarks section. Default value is **False**.|
44+
| _FixedFormatExtClassPtr_|Optional| **Variant**|Specifies a pointer to an add-in that allows calls to an alternate implementation of code. The alternate implementation of code interprets the EMF and EMF+ page descriptions that are generated by the applications to make their own PDF or XPS. For more information, see [Extending Office PDF Export](../../pdf/extendingofficepdfexport).|
45+
46+
## Remarks
47+
48+
The _KeepIRM_ parameter behaves specially for PDF. It controls the retention of both labels and encryption to the output file. For more information, see [Manage sensitivity labels in Office apps](/microsoft-365/compliance/sensitivity-labels-office-apps?view=o365-worldwide#pdf-support&preserve-view=true).
49+
50+
The _ImproveExportTagging_ parameter enables improved accessibility tagging for footnotes/endnotes, block quotes, inline quotes, captions, title, comments, equations, layout tables, and nodes (paragraphs, lists, tables) spanning pages. When using the _FixedFormatExtClassPtr_ parameter, your handling of footnotes/endnotes, comments, layout tables, and nodes spanning pages will have to be updated when migrating from **Document.ExportAsFixedFormat2**. See the "Post-processing tips" section within the "HrBeginStructNode" section in [Extending Office PDF Export](../../pdf/extendingofficepdfexport) for more information.
51+
52+
## Requirements
53+
54+
Microsoft 365 Beta Channel 16.0.18720.20000
55+
56+
### See also
57+
[Manage sensitivity labels in Office apps](/microsoft-365/compliance/sensitivity-labels-office-apps?view=o365-worldwide#pdf-support&preserve-view=true)
58+
59+
[Extending Office PDF Export](../../pdf/extendingofficepdfexport)
60+
61+
[!include[Support and feedback](~/includes/feedback-boilerplate.md)]

‎api/Word.Document.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -92,6 +92,7 @@ ActiveDocument.PrintOut
9292
- [EndReview](Word.Document.EndReview.md)
9393
- [ExportAsFixedFormat](Word.Document.ExportAsFixedFormat.md)
9494
- [ExportAsFixedFormat2](Word.Document.ExportAsFixedFormat2.md)
95+
- [ExportAsFixedFormat3](Word.Document.ExportAsFixedFormat3.md)
9596
- [FitToPages](Word.Document.FitToPages.md)
9697
- [FollowHyperlink](Word.Document.FollowHyperlink.md)
9798
- [FreezeLayout](Word.Document.FreezeLayout.md)

‎api/Word.Range.ExportAsFixedFormat3.md

Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
---
2+
title: Range.ExportAsFixedFormat3 method (Word)
3+
keywords: vbawd10.chm157155831
4+
f1_keywords:
5+
- vbawd10.chm157155831
6+
api_name:
7+
- Word.Range.ExportAsFixedFormat3
8+
ms.assetid: d1cf9c7d-f2f3-1962-eccf-262568a56ad9
9+
ms.date: 03/26/2025
10+
ms.localizationpriority: medium
11+
---
12+
13+
14+
# Range.ExportAsFixedFormat3 method (Word)
15+
16+
Saves a portion of a document as PDF or XPS format.
17+
18+
19+
## Syntax
20+
21+
_expression_.**ExportAsFixedFormat3** (_OutputFileName_, _ExportFormat_, _OpenAfterExport_, _OptimizeFor_, _ExportCurrentPage_, _Item_, _IncludeDocProps_, _KeepIRM_, _CreateBookmarks_, _DocStructureTags_, _BitmapMissingFonts_, _UseISO19005\_1_, _OptimizeForImageQuality_, _ImproveExportTagging_, _FixedFormatExtClassPtr_)
22+
23+
_expression_ An expression that returns a **[Range](Word.Range.md)** object.
24+
25+
26+
## Parameters
27+
28+
|Name|Required/Optional|Data type|Description|
29+
|:-----|:-----|:-----|:-----|
30+
| _OutputFileName_|Required| **String**|The path and file name of the new PDF or XPS file.|
31+
| _ExportFormat_|Required| **[WdExportFormat](Word.WdExportFormat.md)**|Specifies either PDF or XPS format.|
32+
| _OpenAfterExport_|Optional| **Boolean**|Opens the new file after exporting the contents.|
33+
| _OptimizeFor_|Optional| **[WdExportOptimizeFor](Word.WdExportOptimizeFor.md)**|Specifies whether to optimize for screen or print.|
34+
| _ExportCurrentPage_|Optional| **Boolean**|Specifies whether to export the current page. **True** exports the entire page. **False** exports only the current selection.|
35+
| _Item_|Optional| **[WdExportItem](Word.WdExportItem.md)**|Specifies whether the export process includes text only or includes text with markup.|
36+
| _IncludeDocProps_|Optional| **Boolean**|Specifies whether to include document properties in the newly exported file.|
37+
| _KeepIRM_|Optional| **Boolean**|Specifies whether to copy IRM permissions to an XPS document if the source document has IRM protections. Default value is **True**.|
38+
| _CreateBookmarks_|Optional| **[WdExportCreateBookmarks](Word.WdExportCreateBookmarks.md)**|Specifies whether to export bookmarks and the type of bookmarks to export.|
39+
| _DocStructureTags_|Optional| **Boolean**|Specifies whether to include extra data to help screen readers, for example information about the flow and logical organization of the content. Default value is **True**.|
40+
| _BitmapMissingFonts_|Optional| **Boolean**|Specifies whether to include a bitmap of the text. Set this parameter to **True** when font licenses don't permit a font to be embedded in the PDF file. If **False**, the font is referenced, and the viewer's computer substitutes an appropriate font if the authored one is not available. Default value is **True**.|
41+
| _UseISO19005\_1_|Optional| **Boolean**|Specifies whether to limit PDF usage to the PDF subset standardized as ISO 19005-1. If **True**, the resulting files are more reliably self-contained but may be larger or show more visual artifacts due to the restrictions of the format. Default value is **False**.|
42+
| _OptimizeForImageQuality_|Optional| **Boolean**|Specifies whether to downsample images or keep their original quality. If **True**, the resulting files will have better image quality but may be larger. Default value is **False**.|
43+
| _ImproveExportTagging_|Optional| **Boolean**|Specifies whether to enable improved accessbility tagging. For more information, see the Remarks section. Default value is **False**.|
44+
| _FixedFormatExtClassPtr_|Optional| **Variant**|Specifies a pointer to an add-in that allows calls to an alternate implementation of code. The alternate implementation of code interprets the EMF and EMF+ page descriptions that are generated by the applications to make their own PDF or XPS. For more information, see [Extending Office PDF Export](../../pdf/extendingofficepdfexport).|
45+
46+
47+
## Remarks
48+
49+
The _KeepIRM_ parameter behaves specially for PDF. It controls the retention of both labels and encryption to the output file. For more information, see [Manage sensitivity labels in Office apps](/microsoft-365/compliance/sensitivity-labels-office-apps?view=o365-worldwide#pdf-support&preserve-view=true).
50+
51+
The _ImproveExportTagging_ parameter enables improved accessibility tagging for footnotes/endnotes, block quotes, inline quotes, captions, title, comments, equations, layout tables, and nodes (paragraphs, lists, tables) spanning pages. When using the _FixedFormatExtClassPtr_ parameter, your handling of footnotes/endnotes, comments, layout tables, and nodes spanning pages will have to be updated when migrating from **Document.ExportAsFixedFormat2**. See the "Post-processing tips" section within the "HrBeginStructNode" section in [Extending Office PDF Export](../../pdf/extendingofficepdfexport) for more information.
52+
53+
54+
## Requirements
55+
56+
Microsoft 365 Beta Channel 16.0.18720.20000
57+
58+
### See also
59+
[Manage sensitivity labels in Office apps](/microsoft-365/compliance/sensitivity-labels-office-apps?view=o365-worldwide#pdf-support&preserve-view=true)
60+
61+
[Extending Office PDF Export](../../pdf/extendingofficepdfexport)
62+
63+
[!include[Support and feedback](~/includes/feedback-boilerplate.md)]

‎api/Word.Range.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -63,6 +63,7 @@ For more information about working with **Range** objects, see [Working with Ran
6363
- [Expand](Word.Range.Expand.md)
6464
- [ExportAsFixedFormat](Word.Range.ExportAsFixedFormat.md)
6565
- [ExportAsFixedFormat2](Word.Range.ExportAsFixedFormat2.md)
66+
- [ExportAsFixedFormat3](Word.Range.ExportAsFixedFormat3.md)
6667
- [ExportFragment](Word.Range.ExportFragment.md)
6768
- [GetSpellingSuggestions](Word.Range.GetSpellingSuggestions.md)
6869
- [GoTo](Word.Range.GoTo.md)

‎api/Word.Selection.ExportAsFixedFormat3.md

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
---
2+
title: Selection.ExportAsFixedFormat3 method (Word)
3+
keywords: vbawd10.chm158663692
4+
f1_keywords:
5+
- vbawd10.chm158663692
6+
api_name:
7+
- Word.Selection.ExportAsFixedFormat3
8+
ms.assetid: 0fc22f07-6a21-d04e-e90b-73e33f5e4f36
9+
ms.date: 03/26/2025
10+
ms.localizationpriority: medium
11+
---
12+
13+
14+
# Selection.ExportAsFixedFormat3 method (Word)
15+
16+
Saves the current selection as PDF or XPS format.
17+
18+
19+
## Syntax
20+
21+
_expression_.**ExportAsFixedFormat3** (_OutputFileName_, _ExportFormat_, _OpenAfterExport_, _OptimizeFor_, _ExportCurrentPage_, _Item_, _IncludeDocProps_, _KeepIRM_, _CreateBookmarks_, _DocStructureTags_, _BitmapMissingFonts_, _UseISO19005\_1_, _OptimizeForImageQuality_, _ImproveExportTagging_, _FixedFormatExtClassPtr_)
22+
23+
_expression_ An expression that returns a **[Selection](Word.Selection.md)** object.
24+
25+
26+
## Parameters
27+
28+
|Name|Required/Optional|Data type|Description|
29+
|:-----|:-----|:-----|:-----|
30+
| _OutputFileName_|Required| **String**|The path and file name of the new PDF or XPS file.|
31+
| _ExportFormat_|Required| **[WdExportFormat](Word.WdExportFormat.md)**|Specifies either PDF or XPS format.|
32+
| _OpenAfterExport_|Optional| **Boolean**|Opens the new file after exporting the contents.|
33+
| _OptimizeFor_|Optional| **[WdExportOptimizeFor](Word.WdExportOptimizeFor.md)**|Specifies whether to optimize for screen or print.|
34+
| _ExportCurrentPage_|Optional| **Boolean**|Specifies whether to export the current page. **True** exports the entire page. **False** exports only the current selection.|
35+
| _Item_|Optional| **[WdExportItem](Word.WdExportItem.md)**|Specifies whether the export process includes text only or includes text with markup.|
36+
| _IncludeDocProps_|Optional| **Boolean**|Specifies whether to include document properties in the newly exported file.|
37+
| _KeepIRM_|Optional| **Boolean**|Specifies whether to copy IRM permissions to an XPS document if the source document has IRM protections.</br></br>If _ExportFormat_ is _wdExportFormatPDF_, this flag also specifies whether to copy labels to the PDF.</br></br>Default value is **True**.|
38+
| _CreateBookmarks_|Optional| **[WdExportCreateBookmarks](Word.WdExportCreateBookmarks.md)**|Specifies whether to export bookmarks and the type of bookmarks to export.|
39+
| _DocStructureTags_|Optional| **Boolean**|Specifies whether to include extra data to help screen readers, for example information about the flow and logical organization of the content. Default value is **True**.|
40+
| _BitmapMissingFonts_|Optional| **Boolean**|Specifies whether to include a bitmap of the text. Set this parameter to **True** when font licenses don't permit a font to be embedded in the PDF file. If **False**, the font is referenced, and the viewer's computer substitutes an appropriate font if the authored one is not available. Default value is **True**.|
41+
| _UseISO19005\_1_|Optional| **Boolean**|Specifies whether to limit PDF usage to the PDF subset standardized as ISO 19005-1. If **True**, the resulting files are more reliably self-contained but may be larger or show more visual artifacts due to the restrictions of the format. Default value is **False**.|
42+
| _OptimizeForImageQuality_|Optional| **Boolean**|Specifies whether to downsample images or keep their original quality. If **True**, the resulting files will have better image quality but may be larger. Default value is **False**.|
43+
| _ImproveExportTagging_|Optional| **Boolean**|Specifies whether to enable improved accessbility tagging. For more information, see the Remarks section. Default value is **False**.|
44+
| _FixedFormatExtClassPtr_|Optional| **Variant**|Specifies a pointer to an add-in that allows calls to an alternate implementation of code. The alternate implementation of code interprets the EMF and EMF+ page descriptions that are generated by the applications to make their own PDF or XPS. For more information, see [Extending Office PDF Export](../../pdf/extendingofficepdfexport).|
45+
46+
## Remarks
47+
48+
The _KeepIRM_ parameter behaves specially for PDF. It controls the retention of both labels and encryption to the output file. For more information, see [Manage sensitivity labels in Office apps](/microsoft-365/compliance/sensitivity-labels-office-apps?view=o365-worldwide#pdf-support&preserve-view=true).
49+
50+
The _ImproveExportTagging_ parameter enables improved accessibility tagging for footnotes/endnotes, block quotes, inline quotes, captions, title, comments, equations, layout tables, and nodes (paragraphs, lists, tables) spanning pages. When using the _FixedFormatExtClassPtr_ parameter, your handling of footnotes/endnotes, comments, layout tables, and nodes spanning pages will have to be updated when migrating from **Document.ExportAsFixedFormat2**. See the "Post-processing tips" section within the "HrBeginStructNode" section in [Extending Office PDF Export](../../pdf/extendingofficepdfexport) for more information.
51+
52+
## Requirements
53+
54+
Microsoft 365 Beta Channel 16.0.18720.20000
55+
56+
### See also
57+
[Manage sensitivity labels in Office apps](/microsoft-365/compliance/sensitivity-labels-office-apps?view=o365-worldwide#pdf-support&preserve-view=true)
58+
59+
[Extending Office PDF Export](../../pdf/extendingofficepdfexport)
60+
61+
[!include[Support and feedback](~/includes/feedback-boilerplate.md)]

‎api/Word.Selection.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -139,6 +139,7 @@ Because **Range** objects share many of the same methods and properties as **Sel
139139
- [Expand](Word.Selection.Expand.md)
140140
- [ExportAsFixedFormat](Word.Selection.ExportAsFixedFormat.md)
141141
- [ExportAsFixedFormat2](Word.Selection.ExportAsFixedFormat2.md)
142+
- [ExportAsFixedFormat3](Word.Selection.ExportAsFixedFormat3.md)
142143
- [Extend](Word.Selection.Extend.md)
143144
- [GoTo](Word.Selection.GoTo.md)
144145
- [GoToEditableRange](Word.Selection.GoToEditableRange.md)

0 commit comments

Comments
 (0)