#[non_exhaustive]pub struct RoomMessageEventContent {
pub msgtype: MessageType,
pub relates_to: Option<Relation<RoomMessageEventContentWithoutRelation>>,
pub mentions: Option<Mentions>,
}
Expand description
The content of an m.room.message
event.
This event is used when sending messages in a room.
Messages are not limited to be text.
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Struct { .. }
syntax; cannot be matched against without a wildcard ..
; and struct update syntax will not work.msgtype: MessageType
A key which identifies the type of message being sent.
This also holds the specific content of each message.
relates_to: Option<Relation<RoomMessageEventContentWithoutRelation>>
Information about related messages.
mentions: Option<Mentions>
The mentions of this event.
This should always be set to avoid triggering the legacy mention push rules. It is
recommended to use Self::set_mentions()
to set this field, that will take care of
populating the fields correctly if this is a replacement.
Implementations§
source§impl RoomMessageEventContent
impl RoomMessageEventContent
sourcepub fn new(msgtype: MessageType) -> RoomMessageEventContent
pub fn new(msgtype: MessageType) -> RoomMessageEventContent
Create a RoomMessageEventContent
with the given MessageType
.
sourcepub fn text_plain(body: impl Into<String>) -> RoomMessageEventContent
pub fn text_plain(body: impl Into<String>) -> RoomMessageEventContent
A constructor to create a plain text message.
sourcepub fn text_html(
body: impl Into<String>,
html_body: impl Into<String>,
) -> RoomMessageEventContent
pub fn text_html( body: impl Into<String>, html_body: impl Into<String>, ) -> RoomMessageEventContent
A constructor to create an html message.
sourcepub fn text_markdown(
body: impl AsRef<str> + Into<String>,
) -> RoomMessageEventContent
pub fn text_markdown( body: impl AsRef<str> + Into<String>, ) -> RoomMessageEventContent
A constructor to create a markdown message.
sourcepub fn notice_plain(body: impl Into<String>) -> RoomMessageEventContent
pub fn notice_plain(body: impl Into<String>) -> RoomMessageEventContent
A constructor to create a plain text notice.
sourcepub fn notice_html(
body: impl Into<String>,
html_body: impl Into<String>,
) -> RoomMessageEventContent
pub fn notice_html( body: impl Into<String>, html_body: impl Into<String>, ) -> RoomMessageEventContent
A constructor to create an html notice.
sourcepub fn notice_markdown(
body: impl AsRef<str> + Into<String>,
) -> RoomMessageEventContent
pub fn notice_markdown( body: impl AsRef<str> + Into<String>, ) -> RoomMessageEventContent
A constructor to create a markdown notice.
sourcepub fn emote_plain(body: impl Into<String>) -> RoomMessageEventContent
pub fn emote_plain(body: impl Into<String>) -> RoomMessageEventContent
A constructor to create a plain text emote.
sourcepub fn emote_html(
body: impl Into<String>,
html_body: impl Into<String>,
) -> RoomMessageEventContent
pub fn emote_html( body: impl Into<String>, html_body: impl Into<String>, ) -> RoomMessageEventContent
A constructor to create an html emote.
sourcepub fn emote_markdown(
body: impl AsRef<str> + Into<String>,
) -> RoomMessageEventContent
pub fn emote_markdown( body: impl AsRef<str> + Into<String>, ) -> RoomMessageEventContent
A constructor to create a markdown emote.
sourcepub fn make_reply_to(
self,
original_message: &OriginalMessageLikeEvent<RoomMessageEventContent>,
forward_thread: ForwardThread,
add_mentions: AddMentions,
) -> RoomMessageEventContent
pub fn make_reply_to( self, original_message: &OriginalMessageLikeEvent<RoomMessageEventContent>, forward_thread: ForwardThread, add_mentions: AddMentions, ) -> RoomMessageEventContent
Turns self
into a reply to the given message.
Takes the body
/ formatted_body
(if any) in self
for the main text and prepends a
quoted version of original_message
. Also sets the in_reply_to
field inside relates_to
,
and optionally the rel_type
to m.thread
if the `original_message is in a thread and
thread forwarding is enabled.
This function requires an OriginalRoomMessageEvent
since it creates a permalink to
the previous message, for which the room ID is required. If you want to reply to an
OriginalSyncRoomMessageEvent
, you have to convert it first by calling .into_full_event()
.
If the message was edited, the previous message should be the original message that was edited, with the content of its replacement, to allow the fallback to be accurate at the time it is added.
It is recommended to enable the html
feature when using this method as this will
clean up nested rich reply fallbacks in chains of replies. This uses sanitize_html()
internally, with RemoveReplyFallback::Yes
.
§Panics
Panics if self
has a formatted_body
with a format other than HTML.
sourcepub fn make_reply_to_raw(
self,
original_event: &Raw<AnySyncTimelineEvent>,
original_event_id: OwnedEventId,
room_id: &RoomId,
forward_thread: ForwardThread,
add_mentions: AddMentions,
) -> RoomMessageEventContent
pub fn make_reply_to_raw( self, original_event: &Raw<AnySyncTimelineEvent>, original_event_id: OwnedEventId, room_id: &RoomId, forward_thread: ForwardThread, add_mentions: AddMentions, ) -> RoomMessageEventContent
Turns self
into a reply to the given raw event.
Takes the body
/ formatted_body
(if any) in self
for the main text and prepends a
quoted version of the body
of original_event
(if any). Also sets the in_reply_to
field
inside relates_to
, and optionally the rel_type
to m.thread
if the
`original_message is in a thread and thread forwarding is enabled.
It is recommended to use Self::make_reply_to()
for replies to m.room.message
events,
as the generated fallback is better for some msgtype
s.
Note that except for the panic below, this is infallible. Which means that if a field is
missing when deserializing the data, the changes that require it will not be applied. It
will still at least apply the m.in_reply_to
relation to this content.
§Panics
Panics if self
has a formatted_body
with a format other than HTML.
sourcepub fn make_for_thread(
self,
previous_message: &OriginalMessageLikeEvent<RoomMessageEventContent>,
is_reply: ReplyWithinThread,
add_mentions: AddMentions,
) -> RoomMessageEventContent
pub fn make_for_thread( self, previous_message: &OriginalMessageLikeEvent<RoomMessageEventContent>, is_reply: ReplyWithinThread, add_mentions: AddMentions, ) -> RoomMessageEventContent
Turns self
into a new message for a thread, that is optionally a reply.
Looks for a Relation::Thread
in previous_message
. If it exists, this message will be
in the same thread. If it doesn’t, a new thread with previous_message
as the root is
created.
If this is a reply within the thread, takes the body
/ formatted_body
(if any) in self
for the main text and prepends a quoted version of previous_message
. Also sets the
in_reply_to
field inside relates_to
.
This function requires an OriginalRoomMessageEvent
since it creates a permalink to
the previous message, for which the room ID is required. If you want to reply to an
OriginalSyncRoomMessageEvent
, you have to convert it first by calling .into_full_event()
.
If the message was edited, the previous message should be the original message that was edited, with the content of its replacement, to allow the fallback to be accurate at the time it is added.
It is recommended to enable the html
feature when using this method as this will
clean up nested rich reply fallbacks in chains of replies. This uses sanitize_html()
internally, with RemoveReplyFallback::Yes
.
§Panics
Panics if this is a reply within the thread and self
has a formatted_body
with a format
other than HTML.
sourcepub fn make_replacement(
self,
metadata: impl Into<ReplacementMetadata>,
replied_to_message: Option<&OriginalMessageLikeEvent<RoomMessageEventContent>>,
) -> RoomMessageEventContent
pub fn make_replacement( self, metadata: impl Into<ReplacementMetadata>, replied_to_message: Option<&OriginalMessageLikeEvent<RoomMessageEventContent>>, ) -> RoomMessageEventContent
Turns self
into a replacement (or edit) for a given message.
The first argument after self
can be &OriginalRoomMessageEvent
or
&OriginalSyncRoomMessageEvent
if you don’t want to create ReplacementMetadata
separately
before calling this function.
This takes the content and sets it in m.new_content
, and modifies the content
to include
a fallback.
If the message that is replaced is a reply to another message, the latter should also be
provided to be able to generate a rich reply fallback that takes the body
/
formatted_body
(if any) in self
for the main text and prepends a quoted version of
original_message
.
This function requires an OriginalRoomMessageEvent
since it creates a permalink to
the previous message, for which the room ID is required. If you want to reply to an
OriginalSyncRoomMessageEvent
, you have to convert it first by calling .into_full_event()
.
If the message was edited, the previous message should be the original message that was edited, with the content of its replacement, to allow the fallback to be accurate at the time it is added.
It is recommended to enable the html
feature when using this method as this will
clean up nested rich reply fallbacks in chains of replies. This uses sanitize_html()
internally, with RemoveReplyFallback::Yes
.
If this message contains Mentions
, they are copied into m.new_content
to keep the same
mentions, but the ones in content
are filtered with the ones in the
ReplacementMetadata
so only new mentions will trigger a notification.
§Panics
Panics if self
has a formatted_body
with a format other than HTML.
sourcepub fn set_mentions(self, mentions: Mentions) -> RoomMessageEventContent
👎Deprecated: Call add_mentions before adding the relation instead.
pub fn set_mentions(self, mentions: Mentions) -> RoomMessageEventContent
Set the mentions of this event.
If this event is a replacement, it will update the mentions both in the content
and the
m.new_content
so only new mentions will trigger a notification. As such, this needs to be
called after Self::make_replacement()
.
It is not recommended to call this method after one that sets mentions automatically, like
Self::make_reply_to()
as these will be overwritten. Self::add_mentions()
should be
used instead.
sourcepub fn add_mentions(self, mentions: Mentions) -> RoomMessageEventContent
pub fn add_mentions(self, mentions: Mentions) -> RoomMessageEventContent
Add the given mentions to this event.
If no Mentions
was set on this events, this sets it. Otherwise, this updates the current
mentions by extending the previous user_ids
with the new ones, and applies a logical OR to
the values of room
.
This should be called before methods that add a relation, like Self::make_reply_to()
and
Self::make_replacement()
, for the mentions to be correctly set.
sourcepub fn msgtype(&self) -> &str
pub fn msgtype(&self) -> &str
Returns a reference to the msgtype
string.
If you want to access the message type-specific data rather than the message type itself,
use the msgtype
field, not this method.
sourcepub fn apply_replacement(
&mut self,
new_content: RoomMessageEventContentWithoutRelation,
)
pub fn apply_replacement( &mut self, new_content: RoomMessageEventContentWithoutRelation, )
Apply the given new content from a Replacement
to this message.
sourcepub fn sanitize(
&mut self,
mode: HtmlSanitizerMode,
remove_reply_fallback: RemoveReplyFallback,
)
pub fn sanitize( &mut self, mode: HtmlSanitizerMode, remove_reply_fallback: RemoveReplyFallback, )
Sanitize this message.
If this message contains HTML, this removes the tags and attributes that are not listed in the Matrix specification.
It can also optionally remove the rich reply fallback from the plain text and HTML message.
This method is only effective on text, notice and emote messages.
Trait Implementations§
source§impl Clone for RoomMessageEventContent
impl Clone for RoomMessageEventContent
source§fn clone(&self) -> RoomMessageEventContent
fn clone(&self) -> RoomMessageEventContent
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for RoomMessageEventContent
impl Debug for RoomMessageEventContent
source§impl<'de> Deserialize<'de> for RoomMessageEventContent
impl<'de> Deserialize<'de> for RoomMessageEventContent
source§fn deserialize<D>(
deserializer: D,
) -> Result<RoomMessageEventContent, <D as Deserializer<'de>>::Error>where
D: Deserializer<'de>,
fn deserialize<D>(
deserializer: D,
) -> Result<RoomMessageEventContent, <D as Deserializer<'de>>::Error>where
D: Deserializer<'de>,
source§impl EventContent for RoomMessageEventContent
impl EventContent for RoomMessageEventContent
§type EventType = MessageLikeEventType
type EventType = MessageLikeEventType
source§fn event_type(&self) -> <RoomMessageEventContent as EventContent>::EventType
fn event_type(&self) -> <RoomMessageEventContent as EventContent>::EventType
m.room.message
.source§impl From<MessageType> for RoomMessageEventContent
impl From<MessageType> for RoomMessageEventContent
source§fn from(msgtype: MessageType) -> RoomMessageEventContent
fn from(msgtype: MessageType) -> RoomMessageEventContent
source§impl From<RoomMessageEventContent> for AnyMessageLikeEventContent
impl From<RoomMessageEventContent> for AnyMessageLikeEventContent
source§fn from(c: RoomMessageEventContent) -> AnyMessageLikeEventContent
fn from(c: RoomMessageEventContent) -> AnyMessageLikeEventContent
source§impl From<RoomMessageEventContent> for MessageType
impl From<RoomMessageEventContent> for MessageType
source§fn from(content: RoomMessageEventContent) -> MessageType
fn from(content: RoomMessageEventContent) -> MessageType
source§impl From<RoomMessageEventContent> for RoomMessageEventContentWithoutRelation
impl From<RoomMessageEventContent> for RoomMessageEventContentWithoutRelation
source§fn from(
value: RoomMessageEventContent,
) -> RoomMessageEventContentWithoutRelation
fn from( value: RoomMessageEventContent, ) -> RoomMessageEventContentWithoutRelation
source§impl From<RoomMessageEventContentWithoutRelation> for RoomMessageEventContent
impl From<RoomMessageEventContentWithoutRelation> for RoomMessageEventContent
source§fn from(
value: RoomMessageEventContentWithoutRelation,
) -> RoomMessageEventContent
fn from( value: RoomMessageEventContentWithoutRelation, ) -> RoomMessageEventContent
source§impl RedactContent for RoomMessageEventContent
impl RedactContent for RoomMessageEventContent
§type Redacted = RedactedRoomMessageEventContent
type Redacted = RedactedRoomMessageEventContent
source§fn redact(self, version: &RoomVersionId) -> RedactedRoomMessageEventContent
fn redact(self, version: &RoomVersionId) -> RedactedRoomMessageEventContent
self
into a redacted form (removing most or all fields) according to the spec. Read moresource§impl Serialize for RoomMessageEventContent
impl Serialize for RoomMessageEventContent
source§fn serialize<__S>(
&self,
__serializer: __S,
) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>where
__S: Serializer,
fn serialize<__S>(
&self,
__serializer: __S,
) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>where
__S: Serializer,
impl MessageLikeEventContent for RoomMessageEventContent
Auto Trait Implementations§
impl Freeze for RoomMessageEventContent
impl RefUnwindSafe for RoomMessageEventContent
impl Send for RoomMessageEventContent
impl Sync for RoomMessageEventContent
impl Unpin for RoomMessageEventContent
impl UnwindSafe for RoomMessageEventContent
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
source§default unsafe fn clone_to_uninit(&self, dst: *mut T)
default unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)