Comment
Overview
Comment is a class in Aspose.Words FOSS for .NET.
Inherits from: InlineStory, INodeWithAnnotationId, IMoveTrackableNode.
Represents a container for text of a comment.
This class provides 33 methods for working with Comment objects in .NET programs.
Available methods include: Accept, AcceptEnd, AcceptStart, AddReply, AppendChild, Clone, Comment, CreateNavigator, EnsureMinimum, GetAncestor, GetAncestorOf, GetChild, and 20 additional methods.
All public members are accessible to any .NET application after installing the Aspose.Words FOSS for .NET package.
Properties: Ancestor, Author, Count, CustomNodeId, DateTime, DateTimeUtc, and 26 more.
Properties
| Name | Type | Access | Description |
|---|---|---|---|
NodeType | NodeType | Read | Returns Comment. |
StoryType | StoryType | Read | Returns Comments. |
Id | int | Read/Write | Gets or sets the comment identifier. |
Initial | string | Read/Write | Returns or sets the initials of the user associated with a specific comment. |
DateTime | DateTime | Read/Write | Gets the date and time that the comment was made. |
DateTimeUtc | DateTime | Read | Gets the UTC date and time that the comment was made. |
Author | string | Read/Write | Returns or sets the author name for a comment. |
Ancestor | Comment | Read | Returns the parent Comment object. |
Replies | CommentCollection | Read | Returns a collection of Comment objects that are immediate children of the specified comment. |
Done | bool | Read/Write | Gets or sets flag indicating that the comment has been marked done. |
ParentId | int | Read/Write | Gets or sets the parent comment ID. |
ParentParagraph | Paragraph | Read | Retrieves the parent Paragraph of this node. |
FirstParagraph | Paragraph | Read | Gets the first paragraph in the story. |
LastParagraph | Paragraph | Read | Gets the last paragraph in the story. |
Paragraphs | ParagraphCollection | Read | Gets a collection of paragraphs that are immediate children of the story. |
Tables | TableCollection | Read | Gets a collection of tables that are immediate children of the story. |
IsInsertRevision | bool | Read | Gets the is insert revision. |
IsDeleteRevision | bool | Read | Gets the is delete revision. |
IsMoveFromRevision | bool | Read | Gets the is move from revision. |
IsMoveToRevision | bool | Read | Gets the is move to revision. |
Font | Font | Read | Provides access to the font formatting of the anchor character of this object. |
IsComposite | bool | Read | Returns true as this node can have child nodes. |
HasChildNodes | bool | Read | Returns true if this node has any child nodes. |
FirstChild | Node | Read | Gets the first child of the node. |
LastChild | Node | Read | Gets the last child of the node. |
Count | int | Read | Gets the number of immediate children of this node. |
ParentNode | CompositeNode | Read | Gets the immediate parent of this node. |
Document | DocumentBase | Read | Gets the document to which this node belongs. |
PreviousSibling | Node | Read | Gets the node immediately preceding this node. |
NextSibling | Node | Read | Gets the node immediately following this node. |
Range | Range | Read | Returns a Range object that represents the portion of a document that is contained in this node. |
CustomNodeId | int | Read/Write | Specifies custom node identifier. |
Methods
| Signature | Description |
|---|---|
Comment(doc: DocumentBase) | Initializes a new instance of the Comment class. |
Comment(doc: DocumentBase, author: string, initial: string, dateTime: DateTime) | Initializes a new instance of the Comment class. |
Accept(visitor: DocumentVisitor) | Calls VisitCommentStart, then calls Accept for all child nodes of the comment and calls VisitCommentEnd at the end. |
AddReply(author: string, initial: string, dateTime: DateTime, text: string) | Adds a reply to this comment. |
RemoveReply(reply: Comment) | Removes the specified reply to this comment. |
RemoveAllReplies() | Removes all replies to this comment. |
AcceptStart(visitor: DocumentVisitor) | Accepts a visitor for visiting the start of the comment. |
AcceptEnd(visitor: DocumentVisitor) | Accepts a visitor for visiting the end of the comment. |
SetText(text: string) | This is a convenience method that allows to easily set text of the comment. |
EnsureMinimum() | If the last child is not a paragraph, creates and appends one empty paragraph. |
GetText() | Gets the text of this node and of all its children. |
GetChildNodes(nodeType: NodeType, isDeep: bool) | Returns a collection of child nodes that match the specified type. |
GetChild(nodeType: NodeType, index: int, isDeep: bool) | Returns an Nth child node that matches the specified type. |
SelectNodes(xpath: string) | Selects a list of nodes matching the XPath expression. |
SelectSingleNode(xpath: string) | Selects the first Node that matches the XPath expression. |
GetEnumerator() | Provides support for the for each style iteration over the child nodes of this node. |
AppendChild(newChild: T) | Adds the specified node to the end of the list of child nodes for this node. |
PrependChild(newChild: T) | Adds the specified node to the beginning of the list of child nodes for this node. |
InsertAfter(newChild: T, refChild: Node) | Inserts the specified node immediately after the specified reference node. |
InsertBefore(newChild: T, refChild: Node) | Inserts the specified node immediately before the specified reference node. |
RemoveChild(oldChild: T) | Removes the specified child node. |
RemoveAllChildren() | Removes all the child nodes of the current node. |
RemoveSmartTags() | Removes all SmartTag descendant nodes of the current node. |
IndexOf(child: Node) | Returns the index of the specified child node in the child node array. |
CreateNavigator() | Creates navigator which can be used to traverse and read nodes. |
Clone(isCloneChildren: bool) | You should use the Clone(bool, INodeCloningListener) overload when the node cloning is a part of another (usually composite) node cloning process. |
GetAncestor(ancestorType: Type) | Gets the first ancestor of the specified object type. |
GetAncestorOf() | Calls GetAncestorOf on this Comment instance. |
Remove() | Removes itself from the parent. |
NextPreOrder(rootNode: Node) | Gets next node according to the pre-order tree traversal algorithm. |
PreviousPreOrder(rootNode: Node) | Gets the previous node according to the pre-order tree traversal algorithm. |
ToString(saveFormat: SaveFormat) | Exports the content of the node into a string in the specified format. |
NodeTypeToString(nodeType: NodeType) | A utility method that converts a node type enum value into a user friendly string. |