BookmarkOptions.ConflictNameResolution Property

Specifies an action that will be performed after inserting a document range if that range contains a bookmark with the same name as one in the current document.

Namespace: DevExpress.XtraRichEdit

Assembly: DevExpress.RichEdit.v19.1.Core.dll

Declaration

C#

[DefaultValue(ConflictNameAction.Keep)]
[XtraSerializableProperty]
public virtual ConflictNameAction ConflictNameResolution { get; set; }

VB.NET

<DefaultValue(ConflictNameAction.Keep)>
<XtraSerializableProperty>
Public Overridable Property ConflictNameResolution As ConflictNameAction

Property Value

Type	Default	Description
ConflictNameAction	**Keep**	A ConflictNameAction enumeration member that identifies an action.

Available values:

Name	Description
Keep	Keep bookmarks with the same name providing different internal names to distinguish them.
Rename	Append the underscore and a number to the name of the bookmark being inserted if the target document already contains a bookmark with the same name.
Skip	Do not create a bookmark if the target document contains a bookmark with the same name as the bookmark being inserted.

Property Paths

You can access this nested property as listed below:

Library	Object Type	Path to ConflictNameResolution
WinForms Controls	SnapControlOptions	.Bookmarks.ConflictNameResolution
	RichEditControlOptions	.Bookmarks.ConflictNameResolution
WPF Controls	RichEditControlOptions	.Bookmarks.ConflictNameResolution
Office File API	RichEditControlOptionsBase	.Bookmarks.ConflictNameResolution
ASP.NET Web Forms Controls	ASPxRichEditSettings	.Bookmarks.ConflictNameResolution

Remarks

The ConflictNameResolution specifies how to deal with conflicting bookmark names when a document containing a bookmark is inserted in another document containing a Bookmark with the same name. This situation may happen in copy-paste operations (PasteSelectionCommand), in the SubDocument.InsertDocumentContent and SubDocument.AppendDocumentContent methods.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ConflictNameResolution property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

bookmarks-and-hyperlinks-simple-example-t548777/CS/BookmarksAndHyperlinksSimpleExample/Form1.cs#L41

bookmarkOptions = richEditControl1.Options.Bookmarks;
bookmarkOptions.ConflictNameResolution = ConflictNameAction.Rename;
bookmarkOptions.Visibility = RichEditBookmarkVisibility.Hidden;

VB.NET

bookmarks-and-hyperlinks-simple-example-t548777/VB/BookmarksAndHyperlinksSimpleExample/Form1.vb#L39

bookmarkOptions = richEditControl1.Options.Bookmarks
bookmarkOptions.ConflictNameResolution = ConflictNameAction.Rename
bookmarkOptions.Visibility = RichEditBookmarkVisibility.Hidden