+ iRt^RIHt^RIt^RIHtHt^RIH t ]'d^RI H t H t ^RI Ht^RIHt^RIHt!R R 4t!R R ] 4tR#) z?Collection providing access to comments added to this document.) annotationsN) TYPE_CHECKINGIterator)BlockItemContainer) CT_Comment CT_Comments) CommentsPart)ParagraphStyle) ParagraphcZ]tRt^tRtRRltRRltRRltRRR lltR R lt R t R #)Commentsz:Collection containing the comments added to this document.c V^8dQhRRRR/#) comments_elmr comments_partr)formats"S/Users/agent/.openclaw/workspace/venv/lib/python3.14/site-packages/docx/comments.py __annotate__Comments.__annotate__s,,[,,c WnW nR#N _comments_elm_comments_part)selfrrs&&&r__init__Comments.__init__s)+rcV^8dQhRR/#)rreturnzIterator[Comment]r)rs"rrrs  + rc DaV3RlSPP4#)z.Iterator over the comments in this collection.c3P<"TFp\VSP4xK R#5ir)Commentr).0 comment_elmrs& r $Comments.__iter__..s( =  K!4!4 5 5=s#&)r comment_lstrsfr__iter__Comments.__iter__s! #11==  rcV^8dQhRR/#rr intr)rs"rrrs333rc @\VPP4#)z*The number of comments in this collection.)lenrr(r)s&r__len__Comments.__len__s4%%1122rc(V^8dQhRRRRRRRR/#)rtextstrauthorinitials str | Noner r#r)rs"rrr#s)(((#(j(Za(rc VPP4pW$nW4n\P P \PP4Vn \W@P4pVR8XdV#\VPR44p\V4pVP^,pVP!V4VFp VP#V R7K V#)a:Add a new comment to the document and return it. The comment is added to the end of the comments collection and is assigned a unique comment-id. If `text` is provided, it is added to the comment. This option provides for the common case where a comment contains a modest passage of plain text. Multiple paragraphs can be added using the `text` argument by separating their text with newlines (`"\\n"`). Between newlines, text is interpreted as it is in `Document.add_paragraph(text=...)`. The default is to place a single empty paragraph in the comment, which is the same behavior as the Word UI when you add a comment. New runs can be added to the first paragraph in the empty comment with `comments.paragraphs[0].add_run()` to adding more complex text with emphasis or images. Additional paragraphs can be added using `.add_paragraph()`. `author` is a required attribute, set to the empty string by default. `initials` is an optional attribute, set to the empty string by default. Passing |None| for the `initials` parameter causes that attribute to be omitted from the XML.  r4)r add_commentr6r7dtdatetimenowtimezoneutcdater#ritersplitnext paragraphsadd_run add_paragraph) rr4r6r7r%commentpara_text_iterfirst_para_text first_parass &&&& rr=Comments.add_comment#s,((446 #';;??2;;??; +':':; 2:Ndjj./~.''* ?+A  ! !q ! ) rc V^8dQhRRRR/#)r comment_idr.r zComment | Noner)rs"rrrMs^^c^n^rc nVPPV4pVe\W P4#R#)zFReturn the comment identified by `comment_id`, or |None| if not found.N)rget_comment_by_idr#r)rrQr%s&& rget Comments.getMs4((:::F .s9As)joinrGr)s&rr4 Comment.textsyy9999rcV^8dQhRR/#)rr zdt.datetime | Noner)rs"rrr^s&&-&rc .VPP#)zpThe date and time this comment was authored. This attribute is optional in the XML, returns |None| if not set. )rarCr)s&r timestampComment.timestamps   %%%r)ra)r:N)rVrWrXrYrZrrIpropertyr6setterrQr7r4rr[ __classcell__)rbs@rr#r#Ss (( (( ]]))$$**__++::&&rr#)rZ __future__rr?r>typingrr docx.blkcntnrrdocx.oxml.commentsrrdocx.parts.commentsrdocx.styles.styler docx.text.paragraphr r r#rrrrs?E"*,:00-?^?^DP& P&r