Skip to main content

DocumentComment

Struct DocumentComment 

Source
pub struct DocumentComment {
    pub start: u32,
    pub end: u32,
    pub uid: String,
    pub author: String,
    pub author_initials: String,
    pub date: String,
    pub resolved: bool,
    pub body: String,
    pub replies: Vec<CommentReply>,
}
Expand description

One comment thread: an opening note anchored to a character range, plus its flat list of replies.

Flat, not a tree: neither DOCX nor ODT’s comment model nests a reply under another reply (Word’s own UI does not offer it either), so a second level of nesting would have nowhere to go in the output format — the model does not pretend to support what no consumer of it can render.

Fields§

§start: u32

[start, end) in the document’s addressable character space. start == end anchors the comment to a single insertion point rather than a highlighted run — both DOCX and ODT accept an empty range there.

§end: u32§uid: String

Durable identifier — see CommentReply::uid.

§author: String§author_initials: String§date: String

ISO-8601 (e.g. "2026-08-09T12:00:00Z").

§resolved: bool

Whether the thread is marked resolved (DOCX w15:done; ODT’s own resolved marker on the annotation). Resolving a thread does not delete it: the opening note and its full reply history are still written out either way, just flagged.

§body: String

Djot source — see CommentReply::body.

§replies: Vec<CommentReply>

Trait Implementations§

Source§

impl Clone for DocumentComment

Source§

fn clone(&self) -> DocumentComment

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Debug for DocumentComment

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl Default for DocumentComment

Source§

fn default() -> DocumentComment

Returns the “default value” for a type. Read more
Source§

impl<'de> Deserialize<'de> for DocumentComment

Source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl Eq for DocumentComment

Source§

impl FromIterator<DocumentComment> for DocumentComments

Source§

fn from_iter<I: IntoIterator<Item = DocumentComment>>(iter: I) -> Self

Creates a value from an iterator. Read more
Source§

impl PartialEq for DocumentComment

Source§

fn eq(&self, other: &DocumentComment) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl Serialize for DocumentComment

Source§

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>
where __S: Serializer,

Serialize this value into the given Serde serializer. Read more
Source§

impl StructuralPartialEq for DocumentComment

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.