CommentDisplayMode enumeration
CommentDisplayMode enumeration
Specifies the rendering mode for document comments.
Members
Name | Description |
---|---|
HIDE | No document comments are rendered. |
SHOW_IN_BALLOONS | Renders document comments in balloons in the margin. This is the default value. |
SHOW_IN_ANNOTATIONS | Renders document comments in annotations. This is only available for Pdf format. |
Examples
Shows how to show comments when saving a document to a rendered format.
doc = aw.Document()
builder = aw.DocumentBuilder(doc)
builder.write("Hello world!")
comment = aw.Comment(doc, "John Doe", "J.D.", datetime.now())
comment.set_text("My comment.")
builder.current_paragraph.append_child(comment)
# SHOW_IN_ANNOTATIONS is only available in Pdf1.7 and Pdf1.5 formats.
# In other formats, it will work similarly to Hide.
doc.layout_options.comment_display_mode = aw.layout.CommentDisplayMode.SHOW_IN_ANNOTATIONS
doc.save(ARTIFACTS_DIR + "Document.show_comments_in_annotations.pdf")
# Note that it's required to rebuild the document page layout (via Document.update_page_layout() method)
# after changing the "Document.layout_options" values.
doc.layout_options.comment_display_mode = aw.layout.CommentDisplayMode.SHOW_IN_BALLOONS
doc.update_page_layout()
doc.save(ARTIFACTS_DIR + "Document.show_comments_in_balloons.pdf")
See Also
- module aspose.words.layout