WordProcessingLoadOptions class Leave feedback
On this page
Options for loading WordProcessing documents.
public class WordProcessingLoadOptions : LoadOptions, IFontSubstituteLoadOptions,
IFontTransformationLoadOptions, IMetadataLoadOptions, IPageMarginOptions,
IPageNumberingLoadOptions, IPageSizeOptions, IResourceLoadingOptions
| name | description |
|---|---|
| WordProcessingLoadOptions() | Initializes new instance of WordProcessingLoadOptions class. |
| AutoDetectRtlDirection { get; set; } | When true (default), paragraphs and runs whose text is dominantly right-to-left will have their bidi flags repaired before conversion. This matches the heuristic Microsoft Word and LibreOffice apply and fixes rendering of Arabic/Hebrew documents produced by generators (notably Google Docs) that emit OOXML without <w:bidi/> and with <w:rtl w:val=“0”/> on runs that contain only RTL script. Set to false to preserve strict OOXML interpretation of the source markup. |
| BookmarkOptions { get; set; } | Bookmarks options |
| ClearBuiltInDocumentProperties { get; set; } | |
| ClearCustomDocumentProperties { get; set; } | |
| CommentDisplayMode { get; set; } | Specifies how comments should be displayed in the output document. Default is ShowInBalloons. |
| ConvertOwned { get; set; } | Implements ConvertOwned Default is false |
| ConvertOwner { get; set; } | Implements ConvertOwner Default is true |
| DefaultFont { get; set; } | Sets the default font for a WordProcessing document. |
| Depth { get; set; } | Implements Depth Default: 1 |
| EmbedTrueTypeFonts { get; set; } | If EmbedTrueTypeFonts is true, GroupDocs.Conversion embed true type fonts in the output document. Default: true |
| FontConfigSubstitutionEnabled { get; set; } | Automatically substitutes missing fonts based on FontConfig in the system. Default: false. |
| FontInfoSubstitutionEnabled { get; set; } | Automatically substitutes missing fonts based on FontInfo in the document. Default: false. |
| FontNameSubstitutionEnabled { get; set; } | Automatically substitutes missing fonts based on the font name. Default: false. |
| FontSubstitutes { get; set; } | Substitutes specific fonts when converting a WordsProcessing document. |
| FontTransformations { get; set; } | Transform existing fonts after document loading and font substitution are complete. Font transformations can modify any fonts in the document, including fonts that were successfully loaded. |
| Format { get; set; } | Input document file type. Is null until a format has been set, so test it for null rather than against Unknown, which it never equals. |
| HideWordTrackedChanges { get; set; } | Hide markup and track changes for Word documents. |
| HyphenationOptions { get; set; } | Set hyphenation options for WordProcessing documents. |
| KeepDateFieldOriginalValue { get; set; } | Keep original value of date field. Default: false |
| MarginSettings { get; set; } | |
| PageNumbering { get; set; } | Enable or disable generation of page numbering in converted document. Default: false |
| Password { get; set; } | Set password to unprotect protected document. |
| PreserveDocumentStructure { get; set; } | Determines whether the document structure should be preserved when converting to PDF (default is false). |
| PreserveFormFields { get; set; } | Specifies whether to preserve Microsoft Word form fields as form fields in PDF or convert them to text. Default is false. |
| ShowFullCommenterName { get; set; } | Show full commenter name in comments. Default is false. |
| SizeSettings { get; set; } | |
| SkipExternalResources { get; set; } | Implements SkipExternalResources |
| UpdateFields { get; set; } | Update fields after loading. Default: false |
| UpdatePageLayout { get; set; } | Update page layout after loading. Default: false |
| UseTextShaper { get; set; } | Specifies whether to use a text shaper for better kerning display. Default is false. |
| WhitelistedResources { get; set; } | Implements WhitelistedResources |
Font Processing Pipeline:
Phase 1 - Font Substitution (during document loading):
• Handles missing/unavailable fonts using FontSubstitutes, DefaultFont, and system substitution
• Processing order: FontName → FontConfig → FontSubstitutes → FontInfo → DefaultFont
Phase 2 - Font Replacement (after document loading):
• Modifies any existing fonts in the loaded document using FontReplacements
• Applied after all font substitution is complete
- namespace GroupDocs.Conversion.Options.Load
Was this page helpful?
Any additional feedback you'd like to share with us?
Please tell us how we can improve this page.
Thank you for your feedback!
We value your opinion. Your feedback will help us improve our documentation.