WordProcessingLoadOptions
Leave feedback
On this page
Options for loading WordProcessing documents.
public class WordProcessingLoadOptions : LoadOptions, IDocumentsContainerLoadOptions,
IFontSubstituteLoadOptions, IFontTransformationLoadOptions, IMetadataLoadOptions,
IPageMarginOptions, IPageNumberingLoadOptions, IPageSizeOptions, IResourceLoadingOptions
| Name | Description |
|---|---|
| WordProcessingLoadOptions() | Initializes new instance of WordProcessingLoadOptions class. |
| Name | Description |
|---|---|
| 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; } | Removes built-in metadata properties from the document. |
| ClearCustomDocumentProperties { get; set; } | Removes custom metadata properties from the document. |
| 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. |
| virtual Format { get; } | Input document file type. |
| 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; } | Page margin settings |
| 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; } | Page size settings |
| 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 |
| Name | Description |
|---|---|
| override Equals(object) | Determines whether two object instances are equal. |
| virtual Equals(ValueObject) | Determines whether two object instances are equal. |
| override GetHashCode() | Serves as the default hash function. |
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
- class LoadOptions
- interface IDocumentsContainerLoadOptions
- interface IFontSubstituteLoadOptions
- interface IFontTransformationLoadOptions
- interface IMetadataLoadOptions
- interface IPageMarginOptions
- interface IPageNumberingLoadOptions
- interface IPageSizeOptions
- interface IResourceLoadingOptions
- namespace GroupDocs.Conversion.Options.Load
- assembly GroupDocs.Conversion
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.