CommentCollection.Create(DocumentRange, String) Method

Creates a new Comment with the specified settings.

Namespace: DevExpress.XtraRichEdit.API.Native

Assembly: DevExpress.RichEdit.v20.2.Core.dll

NuGet Package: DevExpress.RichEdit.Core

NuGet Packages: DevExpress.RichEdit.Core, DevExpress.WindowsDesktop.RichEdit.Core

Declaration

C#

Comment Create(
    DocumentRange range,
    string author
)

VB.NET

Function Create(
    range As DocumentRange,
    author As String
) As Comment

Parameters

Name	Type	Description
range	DocumentRange	A DocumentRange for which a comment is being created.
author	String	A String value that sets the Comment.Author property.

Returns

Type	Description
Comment	A Comment object.

Remarks

Use the Create method to create a comment and add it to the collection of comments in a document.

Example

View Example

CommentsActions.cs

Document document = server.Document;
server.LoadDocument("Documents\\Grimm.docx", DocumentFormat.OpenXml);
DocumentRange docRange = document.Paragraphs[2].Range;
string commentAuthor = "Johnson Alphonso D";
document.Comments.Create(docRange, commentAuthor, DateTime.Now);

CommentsActions.vb

Dim document As Document = server.Document
server.LoadDocument("Documents\Grimm.docx", DocumentFormat.OpenXml)
Dim docRange As DocumentRange = document.Paragraphs(2).Range
Dim commentAuthor As String = "Johnson Alphonso D"
document.Comments.Create(docRange, commentAuthor, Date.Now)

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Create(DocumentRange, String) method.

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#

winforms-richedit-document-api/CS/RichEditAPISample/CodeExamples/SelectionCollection.cs#L114

Comment comment = document.Comments.Create(document.Selection, "");
SubDocument commentDoc = comment.BeginUpdate();

word-document-api-examples/CS/CodeExamples/ProtectionActions.cs#L24

//Insert a comment indicating that the document is protected
document.Comments.Create(document.Paragraphs[0].Range, "Admin");
SubDocument commentDocument = document.Comments[0].BeginUpdate();

wpf-richedit-document-api/CS/DXRichEditControlAPISample/CodeExamples/CommentsActions.cs#L60

    string commentAuthor = "Maryland B. Clopton";
    document.Comments.Create(docRange, commentAuthor);
}

VB.NET

winforms-richedit-document-api/VB/RichEditAPISample/CodeExamples/SelectionCollection.vb#L104

document.Selections.Add(ranges)
Dim comment As DevExpress.XtraRichEdit.API.Native.Comment = document.Comments.Create(document.Selection, "")
Dim commentDoc As DevExpress.XtraRichEdit.API.Native.SubDocument = comment.BeginUpdate()

word-document-api-examples/VB/CodeExamples/ProtectionActions.vb#L21

'Insert a comment indicating that the document is protected
document.Comments.Create(document.Paragraphs(CInt((0))).Range, "Admin")
Dim commentDocument As DevExpress.XtraRichEdit.API.Native.SubDocument = document.Comments(CInt((0))).BeginUpdate()

wpf-richedit-document-api/VB/DXRichEditControlAPISample/CodeExamples/CommentsActions.vb#L54

    Dim commentAuthor As String = "Maryland B. Clopton"
    document.Comments.Create(docRange, commentAuthor)
End Sub