Struct egui::Id

source ·
pub struct Id(/* private fields */);
Expand description

egui tracks widgets frame-to-frame using Ids.

For instance, if you start dragging a slider one frame, egui stores the sliders Id as the current active id so that next frame when you move the mouse the same slider changes, even if the mouse has moved outside the slider.

For some widgets Ids are also used to persist some state about the widgets, such as Window position or whether not a collapsing header region is open.

This implies that the Ids must be unique.

For simple things like sliders and buttons that don’t have any memory and doesn’t move we can use the location of the widget as a source of identity. For instance, a slider only needs a unique and persistent ID while you are dragging the slider. As long as it is still while moving, that is fine.

For things that need to persist state even after moving (windows, collapsing headers) the location of the widgets is obviously not good enough. For instance, a collapsing region needs to remember whether or not it is open even if the layout next frame is different and the collapsing is not lower down on the screen.

Then there are widgets that need no identifiers at all, like labels, because they have no state nor are interacted with.

This is niche-optimized to that Option<Id> is the same size as Id.

Implementations§

source§

impl Id

source

pub const NULL: Self = _

A special Id, in particular as a key to crate::Memory::data for when there is no particular widget to attach the data.

The null Id is still a valid id to use in all circumstances, though obviously it will lead to a lot of collisions if you do use it!

source

pub fn new(source: impl Hash) -> Self

Generate a new Id by hashing some source (e.g. a string or integer).

source

pub fn with(self, child: impl Hash) -> Self

Generate a new Id by hashing the parent Id and the given argument.

source

pub fn short_debug_format(&self) -> String

Short and readable summary

source

pub fn value(&self) -> u64

The inner value of the Id.

This is a high-entropy hash, or Self::NULL.

Trait Implementations§

source§

impl Clone for Id

source§

fn clone(&self) -> Id

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for Id

source§

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

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

impl From<&'static str> for Id

Convenience

source§

fn from(string: &'static str) -> Self

Converts to this type from the input type.
source§

impl From<String> for Id

source§

fn from(string: String) -> Self

Converts to this type from the input type.
source§

impl From<ViewportId> for Id

source§

fn from(id: ViewportId) -> Self

Converts to this type from the input type.
source§

impl Hash for Id

source§

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher. Read more
1.3.0 · source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
source§

impl PartialEq for Id

source§

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

This method tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl Copy for Id

source§

impl Eq for Id

source§

impl StructuralEq for Id

source§

impl StructuralPartialEq for Id

Auto Trait Implementations§

§

impl RefUnwindSafe for Id

§

impl Send for Id

§

impl Sync for Id

§

impl Unpin for Id

§

impl UnwindSafe for Id

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, 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> ToOwned for T
where T: Clone,

§

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>,

§

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<T> SerializableAny for T
where T: 'static + Any + Clone + for<'a> Send + Sync,