Comment

遗产: java.lang.Object, com.aspose.words.Node, com.aspose.words.CompositeNode, com.aspose.words.InlineStory

public class Comment extends InlineStory

表示评论文本的容器。

要了解更多信息,请访问Working with Comments文档文章。

注释是锚定到文本区域或文本位置的注释。评论可以包含任意数量的块级内容。

如果一个Comment对象自己出现,评论被锚定到Comment目的。

要将注释锚定到文本区域,需要三个对象:Comment, CommentRangeStartCommentRangeEnd .所有三个对象都需要共享相同的getId()价值。

Comment是一个内联级节点,只能是Paragraph.

Comment可以包含ParagraphTable子节点。

构造器

构造函数描述
Comment(DocumentBase doc)初始化一个新的实例Comment班级。
Comment(DocumentBase doc, String author, String initial, Date dateTime)初始化一个新的实例Comment班级。

方法

方法描述
accept(DocumentVisitor visitor)接待来访者。
addReply(String author, String initial, Date dateTime, String text)添加对此评论的回复。
appendChild(Node newChild)将指定节点添加到此节点的子节点列表的末尾。
clearRunAttrs()
dd()
deepClone(boolean isCloneChildren)创建节点的副本。
ensureMinimum()如果最后一个孩子不是段落,则创建并附加一个空段落。
equals(Object arg0)
fetchInheritedRunAttr(int fontAttr)
getAncestor()返回父评论对象。
getAncestor(int ancestorType)
getAncestor(Class ancestorType)获取指定对象类型的第一个祖先。
getAuthor()获取评论的作者姓名。
getChild(int nodeType, int index, boolean isDeep)
getChildNodes()获取此节点的所有直接子节点。
getChildNodes(int nodeType, boolean isDeep)
getClass()
getContainer()
getCount()获取此节点的直接子节点数。
getCurrentNode()
getCustomNodeId()指定自定义节点标识符。
getDateTime()获取发表评论的日期和时间。
getDirectRunAttr(int fontAttr)
getDocument()获取此节点所属的文档。
getDocument_IInline()
getDone()获取指示评论已被标记为完成的标志。
getFirstChild()获取节点的第一个子节点。
getFirstParagraph()获取故事的第一段。
getFont()提供对此对象的锚字符的字体格式的访问。
getId()获取评论标识符。
getIdInternal()
getInitial()获取与特定评论关联的用户的姓名缩写。
getLastChild()获取节点的最后一个子节点。
getLastParagraph()获取故事的最后一段。
getNextMatchingNode(Node curNode)
getNextSibling()获取紧跟在该节点之后的节点。
getNodeType()退货NodeType.Comment.
getParagraphs()获取作为故事的直接子级的段落集合。
getParentIdInternal()
getParentNode()获取此节点的直接父级。
getParentParagraph()检索父级Paragraph这个节点的。
getParentParagraph_IInline()
getPreviousSibling()获取紧接在该节点之前的节点。
getRange()返回一个Range表示包含在该节点中的文档部分的对象。
getReplies()返回一个集合Comment作为指定注释的直接子级的对象。
getStoryType()退货StoryType.Comments.
getTables()获取作为故事的直接子项的表的集合。
getText()获取此节点及其所有子节点的文本。
hasChildNodes()如果此节点有任何子节点,则返回 true。
hashCode()
indexOf(Node child)返回子节点数组中指定子节点的索引。
insertAfter(Node newChild, Node refChild)在指定的引用节点之后立即插入指定的节点。
insertBefore(Node newChild, Node refChild)将指定节点插入到紧靠指定引用节点之前。
isComposite()返回 true,因为此节点可以有子节点。
isDeleteRevision()如果启用更改跟踪时此对象在 Microsoft Word 中被删除,则返回 true。
isInsertRevision()如果在启用更改跟踪时将此对象插入 Microsoft Word,则返回 true。
isMoveFromRevision()退货true如果启用更改跟踪时此对象在 Microsoft Word 中被移动(删除)。
isMoveToRevision()退货true如果启用更改跟踪时在 Microsoft Word 中移动(插入)此对象。
iterator()为该节点的子节点上的每个样式迭代提供支持。
nextPreOrder(Node rootNode)根据前序树遍历算法获取下一个节点。
nodeTypeToString(int nodeType)
notify()
notifyAll()
prependChild(Node newChild)将指定节点添加到此节点的子节点列表的开头。
previousPreOrder(Node rootNode)根据前序树遍历算法获取上一个节点。
remove()从父级中移除自身。
removeAllChildren()移除当前节点的所有子节点。
removeAllReplies()删除对此评论的所有回复。
removeChild(Node oldChild)删除指定的子节点。
removeMoveRevisions()
removeReply(Comment reply)删除对此评论的指定回复。
removeRunAttr(int key)
removeSmartTags()删除所有SmartTag当前节点的后代节点。
selectNodes(String xpath)选择与 XPath 表达式匹配的节点列表。
selectSingleNode(String xpath)选择与 XPath 表达式匹配的第一个节点。
setAuthor(String value)设置评论的作者姓名。
setCustomNodeId(int value)指定自定义节点标识符。
setDateTime(Date value)获取发表评论的日期和时间。
setDone(boolean value)设置标志,指示评论已被标记为完成。
setIdInternal(int value)
setInitial(String value)设置与特定评论关联的用户的首字母。
setParentIdInternal(int value)
setRunAttr(int fontAttr, Object value)
setText(String text)这是一种方便的方法,可以轻松设置评论的文本。
toString()
toString(SaveOptions saveOptions)使用指定的保存选项将节点的内容导出为字符串。
toString(int saveFormat)
wait()
wait(long arg0)
wait(long arg0, int arg1)

Comment(DocumentBase doc)

public Comment(DocumentBase doc)

初始化一个新的实例Comment班级。

什么时候Comment已创建,它属于指定文档,但还不是文档的一部分,并且ParentNode一片空白。

追加Comment在要插入注释的段落上使用 InsertAfter 或 InsertBefore 到文档。

创建评论后,不要忘记设置它getAuthor() / setAuthor(java.lang.String), getInitial() / setInitial(java.lang.String)getDateTime() / setDateTime(java.util.Date)特性。

参数:

范围类型描述
docDocumentBase所有者文件。

Comment(DocumentBase doc, String author, String initial, Date dateTime)

public Comment(DocumentBase doc, String author, String initial, Date dateTime)

初始化一个新的实例Comment班级。

参数:

范围类型描述
docDocumentBase所有者文件。
authorjava.lang.String评论的作者姓名。不能为空。
initialjava.lang.String评论的作者姓名缩写。不能为空。
dateTimejava.util.Date评论的日期和时间。

accept(DocumentVisitor visitor)

public boolean accept(DocumentVisitor visitor)

接待来访者。

枚举此节点及其所有子节点。每个节点调用 DocumentVisitor 上的相应方法。

有关更多信息,请参阅访问者设计模式。

参数:

范围类型描述
visitorDocumentVisitor将访问节点的访问者。

退货: boolean - 如果所有节点都被访问,则为真;如果 DocumentVisitor 在访问所有节点之前停止操作,则返回 false。来电DocumentVisitor.visitCommentStart(com.aspose.words.Comment) , 然后调用Node.accept(com.aspose.words.DocumentVisitor)对于评论和调用的所有子节点DocumentVisitor.visitCommentEnd(com.aspose.words.Comment)在最后。

addReply(String author, String initial, Date dateTime, String text)

public Comment addReply(String author, String initial, Date dateTime, String text)

添加对此评论的回复。

参数:

范围类型描述
authorjava.lang.String回复的作者姓名。
initialjava.lang.String回复的作者姓名缩写。
dateTimejava.util.Date回复的日期和时间。
textjava.lang.String回复文字。

退货: Comment 创建的Comment回复的节点。由于现有的 MS Office 限制,文档中只允许 1 级回复。如果在现有的回复注释上调用此方法,则会引发 java.lang.IllegalStateException 类型的异常。

appendChild(Node newChild)

public Node appendChild(Node newChild)

将指定节点添加到此节点的子节点列表的末尾。

如果 newChild 已经在树中,则首先将其删除。

如果被插入的节点是从另一个文档创建的,你应该使用**M:Aspose.Words.DocumentBase.ImportNode(Aspose.Words.Node,System.Boolean,Aspose.Words.ImportFormatMode)**将节点导入当前文档。然后可以将导入的节点插入到当前文档中。

参数:

范围类型描述
newChildNode要添加的节点。

退货: Node - 添加的节点。

clearRunAttrs()

public void clearRunAttrs()

dd()

public void dd()

deepClone(boolean isCloneChildren)

public Node deepClone(boolean isCloneChildren)

创建节点的副本。

此方法用作节点的复制构造函数。克隆的节点没有父节点,但与原始节点属于同一个文档。

此方法始终执行节点的深层复制。这isCloneChildren参数指定是否也执行复制所有子节点。

参数:

范围类型描述
isCloneChildrenbooleanTrue 递归克隆指定节点下的子树; false 仅克隆节点本身。

退货: Node - 克隆节点。

ensureMinimum()

public void ensureMinimum()

如果最后一个孩子不是段落,则创建并附加一个空段落。

equals(Object arg0)

public boolean equals(Object arg0)

参数:

范围类型描述
arg0java.lang.Object

退货: 布尔值

fetchInheritedRunAttr(int fontAttr)

public Object fetchInheritedRunAttr(int fontAttr)

参数:

范围类型描述
fontAttrint

退货: java.lang.Object

getAncestor()

public Comment getAncestor()

返回父评论对象。为顶级注释返回 null。

退货: Comment - 父评论对象。

getAncestor(int ancestorType)

public CompositeNode getAncestor(int ancestorType)

参数:

范围类型描述
ancestorTypeint

退货: CompositeNode

getAncestor(Class ancestorType)

public CompositeNode getAncestor(Class ancestorType)

获取指定对象类型的第一个祖先。

参数:

范围类型描述
ancestorTypejava.lang.Class要检索的祖先的对象类型。

退货: CompositeNode - 指定类型的祖先,如果未找到此类型的祖先,则为 null。

如果祖先类型等于 ancestorType 或派生自 ancestorType,则祖先类型匹配。

getAuthor()

public String getAuthor()

获取评论的作者姓名。

不能为空。

默认为空字符串。

退货: java.lang.String - 评论的作者姓名。

getChild(int nodeType, int index, boolean isDeep)

public Node getChild(int nodeType, int index, boolean isDeep)

参数:

范围类型描述
nodeTypeint
indexint
isDeepboolean

退货: Node

getChildNodes()

public NodeCollection getChildNodes()

获取此节点的所有直接子节点。

笔记,getChildNodes()相当于调用 GetChildNodes(NodeType.Any, false) 并在每次访问时创建并返回一个新集合。

如果没有子节点,则此属性返回一个空集合。

退货: NodeCollection - 该节点的所有直接子节点。

getChildNodes(int nodeType, boolean isDeep)

public NodeCollection getChildNodes(int nodeType, boolean isDeep)

参数:

范围类型描述
nodeTypeint
isDeepboolean

退货: NodeCollection

getClass()

public final native Class<?> getClass()

退货: java.lang.Class

getContainer()

public CompositeNode getContainer()

退货: CompositeNode

getCount()

public int getCount()

获取此节点的直接子节点数。

退货: int - 此节点的直接子节点数。

getCurrentNode()

public Node getCurrentNode()

退货: Node

getCustomNodeId()

public int getCustomNodeId()

指定自定义节点标识符。

默认为零。

这个标识符可以任意设置和使用。例如,作为获取外部数据的密钥。

重要说明,指定的值不会保存到输出文件中,并且仅在节点生命周期内存在。

退货: int - 相应的 int 值。

getDateTime()

public Date getDateTime()

获取发表评论的日期和时间。

默认值为 03.01.0001。

退货: java.util.Date - 发表评论的日期和时间。

getDirectRunAttr(int fontAttr)

public Object getDirectRunAttr(int fontAttr)

参数:

范围类型描述
fontAttrint

退货: java.lang.Object

getDocument()

public DocumentBase getDocument()

获取此节点所属的文档。

该节点始终属于一个文档,即使它刚刚创建并且尚未添加到树中,或者如果它已从树中删除也是如此。

退货: DocumentBase - 该节点所属的文档。

getDocument_IInline()

public DocumentBase getDocument_IInline()

退货: DocumentBase

getDone()

public boolean getDone()

获取指示评论已被标记为完成的标志。

退货: boolean - 指示评论已被标记为完成的标志。

getFirstChild()

public Node getFirstChild()

获取节点的第一个子节点。如果没有第一个子节点,则返回 null。

退货: Node - 节点的第一个孩子。

getFirstParagraph()

public Paragraph getFirstParagraph()

获取故事的第一段。

退货: Paragraph - 故事的第一段。

getFont()

public Font getFont()

提供对此对象的锚字符的字体格式的访问。

退货: Font - 相应的Font价值。

getId()

public int getId()

获取评论标识符。

注释标识符允许将注释锚定到文档中的文本区域。该区域必须使用CommentRangeStartCommentRangeEnd对象共享相同的标识符值作为Comment目的。

在查找CommentRangeStartCommentRangeEnd链接到此评论的节点。

评论标识符应该在整个文档中是唯一的,Aspose.Words 在加载、保存和合并文档时自动维护评论标识符。

退货: int - 注释标识符。

getIdInternal()

public int getIdInternal()

退货: 整数

getInitial()

public String getInitial()

获取与特定评论关联的用户的姓名缩写。

不能为空。

默认为空字符串。

退货: java.lang.String - 与特定评论关联的用户的姓名首字母。

getLastChild()

public Node getLastChild()

获取节点的最后一个子节点。如果没有最后一个子节点,则返回 null。

退货: Node - 节点的最后一个孩子。

getLastParagraph()

public Paragraph getLastParagraph()

获取故事的最后一段。

退货: Paragraph - 故事的最后一段。

getNextMatchingNode(Node curNode)

public Node getNextMatchingNode(Node curNode)

参数:

范围类型描述
curNodeNode

退货: Node

getNextSibling()

public Node getNextSibling()

获取紧跟在该节点之后的节点。如果没有下一个节点,则返回 null。

退货: Node - 紧接此节点之后的节点。

getNodeType()

public int getNodeType()

退货NodeType.Comment.

退货: 整数 -NodeType.Comment .返回值是其中之一NodeType常数。

getParagraphs()

public ParagraphCollection getParagraphs()

获取作为故事的直接子级的段落集合。

退货: ParagraphCollection - 故事的直接子段落的集合。

getParentIdInternal()

public int getParentIdInternal()

退货: 整数

getParentNode()

public CompositeNode getParentNode()

获取此节点的直接父级。

如果一个节点刚刚被创建并且还没有被添加到树中,或者如果它已经被从树中移除,则父节点为空。

退货: CompositeNode - 此节点的直接父节点。

getParentParagraph()

public Paragraph getParentParagraph()

检索父级Paragraph这个节点的。

退货: Paragraph - 相应的Paragraph价值。

getParentParagraph_IInline()

public Paragraph getParentParagraph_IInline()

退货: Paragraph

getPreviousSibling()

public Node getPreviousSibling()

获取紧接在该节点之前的节点。如果前面没有节点,则返回 null。

退货: Node - 紧接在该节点之前的节点。

getRange()

public Range getRange()

返回一个Range表示包含在该节点中的文档部分的对象。

退货: Range - 一个Range表示包含在该节点中的文档部分的对象。

getReplies()

public CommentCollection getReplies()

返回一个集合Comment作为指定注释的直接子级的对象。

退货: CommentCollection - 一个集合Comment作为指定注释的直接子级的对象。

getStoryType()

public int getStoryType()

退货StoryType.Comments.

退货: 整数 -StoryType.Comments .返回值是其中之一StoryType常数。

getTables()

public TableCollection getTables()

获取作为故事的直接子项的表的集合。

退货: TableCollection 作为故事的直接子项的表的集合。

getText()

public String getText()

获取此节点及其所有子节点的文本。

返回的字符串包括所有控制字符和特殊字符,如ControlChar.

退货: java.lang.字符串

hasChildNodes()

public boolean hasChildNodes()

如果此节点有任何子节点,则返回 true。

退货: boolean - 如果此节点有任何子节点则为真。

hashCode()

public native int hashCode()

退货: 整数

indexOf(Node child)

public int indexOf(Node child)

返回子节点数组中指定子节点的索引。如果在子节点中找不到该节点,则返回 -1。

参数:

范围类型描述
childNode

退货: 整数

insertAfter(Node newChild, Node refChild)

public Node insertAfter(Node newChild, Node refChild)

在指定的引用节点之后立即插入指定的节点。

如果 refChild 为 null,则在子节点列表的开头插入 newChild。

如果 newChild 已经在树中,则首先将其删除。

如果被插入的节点是从另一个文档创建的,你应该使用**M:Aspose.Words.DocumentBase.ImportNode(Aspose.Words.Node,System.Boolean,Aspose.Words.ImportFormatMode)**将节点导入当前文档。然后可以将导入的节点插入到当前文档中。

参数:

范围类型描述
newChildNode要插入的节点。
refChildNode作为参考节点的节点。 newNode 放置在 refNode 之后。

退货: Node - 插入的节点。

insertBefore(Node newChild, Node refChild)

public Node insertBefore(Node newChild, Node refChild)

将指定节点插入到紧靠指定引用节点之前。

如果 refChild 为 null,则在子节点列表的末尾插入 newChild。

如果 newChild 已经在树中,则首先将其删除。

如果被插入的节点是从另一个文档创建的,你应该使用**M:Aspose.Words.DocumentBase.ImportNode(Aspose.Words.Node,System.Boolean,Aspose.Words.ImportFormatMode)**将节点导入当前文档。然后可以将导入的节点插入到当前文档中。

参数:

范围类型描述
newChildNode要插入的节点。
refChildNode作为参考节点的节点。 newChild 放置在此节点之前。

退货: Node - 插入的节点。

isComposite()

public boolean isComposite()

返回 true,因为此节点可以有子节点。

退货: boolean - True 因为这个节点可以有子节点。

isDeleteRevision()

public boolean isDeleteRevision()

如果启用更改跟踪时此对象在 Microsoft Word 中被删除,则返回 true。

退货: 布尔值 - 如果在启用更改跟踪的情况下在 Microsoft Word 中删除了此对象,则为 True。

isInsertRevision()

public boolean isInsertRevision()

如果在启用更改跟踪时将此对象插入 Microsoft Word,则返回 true。

退货: 布尔值 - 如果在启用更改跟踪的情况下将此对象插入到 Microsoft Word 中,则为 True。

isMoveFromRevision()

public boolean isMoveFromRevision()

退货true如果启用更改跟踪时此对象在 Microsoft Word 中被移动(删除)。

退货: 布尔值 -true如果启用更改跟踪时此对象在 Microsoft Word 中被移动(删除)。

isMoveToRevision()

public boolean isMoveToRevision()

退货true如果启用更改跟踪时在 Microsoft Word 中移动(插入)此对象。

退货: 布尔值 -true如果启用更改跟踪时在 Microsoft Word 中移动(插入)此对象。

iterator()

public Iterator iterator()

为该节点的子节点上的每个样式迭代提供支持。

退货: java.util.迭代器

nextPreOrder(Node rootNode)

public Node nextPreOrder(Node rootNode)

根据前序树遍历算法获取下一个节点。

参数:

范围类型描述
rootNodeNode遍历的顶端节点(极限)。

退货: Node - 预定顺序中的下一个节点。如果到达根节点则为空。

nodeTypeToString(int nodeType)

public static String nodeTypeToString(int nodeType)

参数:

范围类型描述
nodeTypeint

退货: java.lang.字符串

notify()

public final native void notify()

notifyAll()

public final native void notifyAll()

prependChild(Node newChild)

public Node prependChild(Node newChild)

将指定节点添加到此节点的子节点列表的开头。

如果 newChild 已经在树中,则首先将其删除。

如果被插入的节点是从另一个文档创建的,你应该使用**M:Aspose.Words.DocumentBase.ImportNode(Aspose.Words.Node,System.Boolean,Aspose.Words.ImportFormatMode)**将节点导入当前文档。然后可以将导入的节点插入到当前文档中。

参数:

范围类型描述
newChildNode要添加的节点。

退货: Node - 添加的节点。

previousPreOrder(Node rootNode)

public Node previousPreOrder(Node rootNode)

根据前序树遍历算法获取上一个节点。

参数:

范围类型描述
rootNodeNode遍历的顶端节点(极限)。

退货: Node 预购顺序中的前一个节点。如果到达根节点则为空。

remove()

public void remove()

从父级中移除自身。

removeAllChildren()

public void removeAllChildren()

移除当前节点的所有子节点。

removeAllReplies()

public void removeAllReplies()

删除对此评论的所有回复。回复的所有组成节点将从文档中删除。

removeChild(Node oldChild)

public Node removeChild(Node oldChild)

删除指定的子节点。

删除节点后,oldChild 的父级设置为 null。

参数:

范围类型描述
oldChildNode要删除的节点。

退货: Node - 删除的节点。

removeMoveRevisions()

public void removeMoveRevisions()

removeReply(Comment reply)

public void removeReply(Comment reply)

删除对此评论的指定回复。回复的所有组成节点将从文档中删除。

参数:

范围类型描述
replyComment删除回复的评论节点。

removeRunAttr(int key)

public void removeRunAttr(int key)

参数:

范围类型描述
keyint

removeSmartTags()

public void removeSmartTags()

删除所有SmartTag当前节点的后代节点。此方法不会删除智能标记的内容。

selectNodes(String xpath)

public NodeList selectNodes(String xpath)

选择与 XPath 表达式匹配的节点列表。

目前仅支持带有元素名称的表达式。不支持使用属性名称的表达式。

参数:

范围类型描述
xpathjava.lang.StringXPath 表达式。

退货: NodeList - 匹配 XPath 查询的节点列表。

selectSingleNode(String xpath)

public Node selectSingleNode(String xpath)

选择与 XPath 表达式匹配的第一个节点。

目前仅支持带有元素名称的表达式。不支持使用属性名称的表达式。

参数:

范围类型描述
xpathjava.lang.StringXPath 表达式。

退货: Node - 与 XPath 查询匹配的第一个节点,如果未找到匹配节点,则为 null。

setAuthor(String value)

public void setAuthor(String value)

设置评论的作者姓名。

不能为空。

默认为空字符串。

参数:

范围类型描述
valuejava.lang.String评论的作者姓名。

setCustomNodeId(int value)

public void setCustomNodeId(int value)

指定自定义节点标识符。

默认为零。

这个标识符可以任意设置和使用。例如,作为获取外部数据的密钥。

重要说明,指定的值不会保存到输出文件中,并且仅在节点生命周期内存在。

参数:

范围类型描述
valueint对应的int值。

setDateTime(Date value)

public void setDateTime(Date value)

获取发表评论的日期和时间。

默认值为 03.01.0001。

参数:

范围类型描述
valuejava.util.Date发表评论的日期和时间。

setDone(boolean value)

public void setDone(boolean value)

设置标志,指示评论已被标记为完成。

参数:

范围类型描述
valueboolean指示评论已标记为完成的标志。

setIdInternal(int value)

public void setIdInternal(int value)

参数:

范围类型描述
valueint

setInitial(String value)

public void setInitial(String value)

设置与特定评论关联的用户的首字母。

不能为空。

默认为空字符串。

参数:

范围类型描述
valuejava.lang.String与特定评论关联的用户的姓名首字母。

setParentIdInternal(int value)

public void setParentIdInternal(int value)

参数:

范围类型描述
valueint

setRunAttr(int fontAttr, Object value)

public void setRunAttr(int fontAttr, Object value)

参数:

范围类型描述
fontAttrint
valuejava.lang.Object

setText(String text)

public void setText(String text)

这是一种方便的方法,可以轻松设置评论的文本。

此方法允许从字符串快速设置评论文本。该字符串可以包含分段符,这将相应地在评论中创建文本段落。如果您想在评论中插入更复杂的元素,例如书签或表格或应用丰富的格式,那么您需要使用适当的节点类来构建评论文本。

参数:

范围类型描述
textjava.lang.String评论的新文本。

toString()

public String toString()

退货: java.lang.字符串

toString(SaveOptions saveOptions)

public String toString(SaveOptions saveOptions)

使用指定的保存选项将节点的内容导出为字符串。

参数:

范围类型描述
saveOptionsSaveOptions指定控制节点保存方式的选项。

退货: java.lang.String - 指定格式的节点内容。

toString(int saveFormat)

public String toString(int saveFormat)

参数:

范围类型描述
saveFormatint

退货: java.lang.字符串

wait()

public final void wait()

wait(long arg0)

public final native void wait(long arg0)

参数:

范围类型描述
arg0long

wait(long arg0, int arg1)

public final void wait(long arg0, int arg1)

参数:

范围类型描述
arg0long
arg1int