CopyPasteOptions.MaintainDocumentSectionSettings Property
Gets or sets whether to retain section settings of a blank document after appending RTF content.
Namespace: DevExpress.XtraRichEdit
Assembly: DevExpress.RichEdit.v24.1.Core.dll
NuGet Packages: DevExpress.RichEdit.Core, DevExpress.Win.Navigation
Declaration
Property Value
| Type | Default | Description |
|---|---|---|
| Boolean | false | true, to keep section settings of a target blank document; otherwise, false. |
Property Paths
You can access this nested property as listed below:
| Object Type | Path to MaintainDocumentSectionSettings |
|---|---|
| RichEditControlOptionsBase |
|
Remarks
The MaintainDocumentSectionSettings option is helpful in following situations.
First, create an empty document as described below. You can either:
- Create a blank document with specific section settings by loading a document from a template.
- Create a new document programmatically (using the CreateNewDocument method) and specify section settings.
- Delete document content in code or by using UI commands.
Next, append the content of another document to the blank document. To accomplish this, you can copy and paste the entire document (CTRL-A - CTRL-C - CTRL-V) or use the SubDocument.AppendDocumentContent or SubDocument.AppendRtfText methods.
By default, when you copy document content to an empty document, the settings of the empty document are ignored. To prevent this, set the MaintainDocumentSectionSettings to true. Then, the copied content takes the settings of the empty document to which it is copied.