Struct MessageEventContent

#[non_exhaustive]
pub struct MessageEventContent {
    pub text: TextContentBlock,
    pub automated: bool,
    pub relates_to: Option<Relation<MessageEventContentWithoutRelation>>,
    pub url_previews: Option<Vec<UrlPreview>>,
}

The payload for an extensible text message.

This is the new primary type introduced in MSC1767 and should only be sent in rooms with a version that supports it. See the documentation of the message module for more information.

To construct a MessageEventContent with a custom TextContentBlock, convert it with MessageEventContent::from() / .into().

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

text: TextContentBlock

The message’s text content.

automated: bool

Whether this message is automated.

relates_to: Option<Relation<MessageEventContentWithoutRelation>>

Information about related messages.

url_previews: Option<Vec<UrlPreview>>

MSC4095-style bundled url previews

Implementations

impl MessageEventContent

pub fn plain(body: impl Into<String>) -> Self

A convenience constructor to create a plain text message.

pub fn html(body: impl Into<String>, html_body: impl Into<String>) -> Self

A convenience constructor to create an HTML message.

pub fn markdown(body: impl AsRef<str> + Into<String>) -> Self

A convenience constructor to create a message from Markdown.

The content includes an HTML message if some Markdown formatting was detected, otherwise only a plain text message is included.

Trait Implementations

impl Clone for MessageEventContent

fn clone(&self) -> MessageEventContent

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for MessageEventContent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MessageEventContent

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl EventContent for MessageEventContent

type EventType = MessageLikeEventType

The Rust enum for the event kind’s known types.

fn event_type(&self) -> Self::EventType

Get the event’s type, like m.room.message.

impl From<MessageEventContent> for AnyMessageLikeEventContent

fn from(c: MessageEventContent) -> Self

Converts to this type from the input type.

impl From<MessageEventContent> for MessageEventContentWithoutRelation

fn from(c: MessageEventContent) -> Self

Converts to this type from the input type.

impl From<TextContentBlock> for MessageEventContent

fn from(text: TextContentBlock) -> Self

Converts to this type from the input type.

impl RedactContent for MessageEventContent

type Redacted = RedactedMessageEventContent

The redacted form of the event’s content.

fn redact(self, version: &RoomVersionId) -> RedactedMessageEventContent

Transform self into a redacted form (removing most or all fields) according to the spec.

impl Serialize for MessageEventContent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StaticEventContent for MessageEventContent

const TYPE: &'static str = "org.matrix.msc1767.message"

The event type.

impl MessageLikeEventContent for MessageEventContent