Struct matrix_sdk_ui::timeline::TimelineBuilder

source ·
pub struct TimelineBuilder { /* private fields */ }
Expand description

Builder that allows creating and configuring various parts of a Timeline.

Implementations§

source§

impl TimelineBuilder

source

pub fn with_focus(self, focus: TimelineFocus) -> Self

Sets up the initial focus for this timeline.

This can be changed later on while the timeline is alive.

source

pub fn with_unable_to_decrypt_hook(self, hook: Arc<UtdHookManager>) -> Self

Sets up a hook to catch unable-to-decrypt (UTD) events for the timeline we’re building.

If it was previously set before, will overwrite the previous one.

source

pub fn with_internal_id_prefix(self, prefix: String) -> Self

Sets the internal id prefix for this timeline.

The prefix will be prepended to any internal ID using when generating timeline IDs for this timeline.

source

pub fn track_read_marker_and_receipts(self) -> Self

Enable tracking of the fully-read marker and the read receipts on the timeline.

source

pub fn event_filter<F>(self, filter: F) -> Self
where F: Fn(&AnySyncTimelineEvent, &RoomVersionId) -> bool + Send + Sync + 'static,

Use the given filter to choose whether to add events to the timeline.

§Arguments
  • filter - A function that takes a deserialized event, and should return true if the event should be added to the Timeline.

If this is not overridden, the timeline uses the default filter that only allows events that are materialized into a Timeline item. For instance, reactions and edits don’t get their own timeline item (as they affect another existing one), so they’re “filtered out” to reflect that.

You can use the default event filter with crate::timeline::default_event_filter so as to chain it with your own event filter, if you want to avoid situations where a read receipt would be attached to an event that doesn’t get its own timeline item.

Note that currently:

  • Not all event types have a representation as a TimelineItem so these are not added no matter what the filter returns.
  • It is not possible to filter out m.room.encrypted events (otherwise they couldn’t be decrypted when the appropriate room key arrives).
source

pub fn add_failed_to_parse(self, add: bool) -> Self

Whether to add events that failed to deserialize to the timeline.

Defaults to true.

source

pub async fn build(self) -> Result<Timeline, Error>

Create a Timeline with the options set on this builder.

Trait Implementations§

source§

impl Debug for TimelineBuilder

source§

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

Formats the value using the given formatter. Read more

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> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, W> HasTypeWitness<W> for T
where W: MakeTypeWitness<Arg = T>, T: ?Sized,

source§

const WITNESS: W = W::MAKE

A constant of the type witness
source§

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

§

type Type = T

The same type as Self, used to emulate type equality bounds (T == U) with associated type equality constraints (T: Identity<Type = U>).
source§

const TYPE_EQ: TypeEq<T, <T as Identity>::Type> = TypeEq::NEW

Proof that Self is the same type as Self::Type, provides methods for casting between Self and Self::Type.
source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
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> IntoEither for T

source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
source§

impl<T> Same for T

§

type Output = T

Should always be Self
source§

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

§

type Error = Infallible

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

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

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

§

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.
source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

source§

fn vzip(self) -> V

source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

impl<T> Any for T
where T: Any,

source§

impl<T> AsyncTraitDeps for T

source§

impl<T> SendOutsideWasm for T
where T: Send,

source§

impl<T> SyncOutsideWasm for T
where T: Sync,