Struct egui::style::Visuals

source ·
pub struct Visuals {
Show 31 fields pub dark_mode: bool, pub override_text_color: Option<Color32>, pub widgets: Widgets, pub selection: Selection, pub hyperlink_color: Color32, pub faint_bg_color: Color32, pub extreme_bg_color: Color32, pub code_bg_color: Color32, pub warn_fg_color: Color32, pub error_fg_color: Color32, pub window_rounding: Rounding, pub window_shadow: Shadow, pub window_fill: Color32, pub window_stroke: Stroke, pub window_highlight_topmost: bool, pub menu_rounding: Rounding, pub panel_fill: Color32, pub popup_shadow: Shadow, pub resize_corner_size: f32, pub text_cursor: Stroke, pub text_cursor_preview: bool, pub clip_rect_margin: f32, pub button_frame: bool, pub collapsing_header_frame: bool, pub indent_has_left_vline: bool, pub striped: bool, pub slider_trailing_fill: bool, pub handle_shape: HandleShape, pub interact_cursor: Option<CursorIcon>, pub image_loading_spinners: bool, pub numeric_color_space: NumericColorSpace,
Expand description

Controls the visual style (colors etc) of egui.

You can change the visuals of a Ui with Ui::visuals_mut and of everything with crate::Context::set_visuals.

If you want to change fonts, use crate::Context::set_fonts instead.


§dark_mode: bool

If true, the visuals are overall dark with light text. If false, the visuals are overall light with dark text.

NOTE: setting this does very little by itself, this is more to provide a convenient summary of the rest of the settings.

§override_text_color: Option<Color32>

Override default text color for all text.

This is great for setting the color of text for any widget.

If text_color is None (default), then the text color will be the same as the foreground stroke color (WidgetVisuals::fg_stroke) and will depend on whether or not the widget is being interacted with.

In the future we may instead modulate the text_color based on whether or not it is interacted with so that visuals.text_color is always used, but its alpha may be different based on whether or not it is disabled, non-interactive, hovered etc.

§widgets: Widgets

Visual styles of widgets

§selection: Selection§hyperlink_color: Color32

The color used for Hyperlink,

§faint_bg_color: Color32

Something just barely different from the background color. Used for crate::Grid::striped.

§extreme_bg_color: Color32

Very dark or light color (for corresponding theme). Used as the background of text edits, scroll bars and others things that needs to look different from other interactive stuff.

§code_bg_color: Color32

Background color behind code-styled monospaced labels.

§warn_fg_color: Color32

A good color for warning text (e.g. orange).

§error_fg_color: Color32

A good color for error text (e.g. red).

§window_rounding: Rounding§window_shadow: Shadow§window_fill: Color32§window_stroke: Stroke§window_highlight_topmost: bool

Highlight the topmost window.

§menu_rounding: Rounding§panel_fill: Color32

Panel background color

§popup_shadow: Shadow§resize_corner_size: f32§text_cursor: Stroke

The color and width of the text cursor

§text_cursor_preview: bool

show where the text cursor would be if you clicked

§clip_rect_margin: f32

Allow child widgets to be just on the border and still have a stroke with some thickness

§button_frame: bool

Show a background behind buttons.

§collapsing_header_frame: bool

Show a background behind collapsing headers.

§indent_has_left_vline: bool

Draw a vertical lien left of indented region, in e.g. crate::CollapsingHeader.

§striped: bool

Whether or not Grids and Tables should be striped by default (have alternating rows differently colored).

§slider_trailing_fill: bool

Show trailing color behind the circle of a Slider. Default is OFF.

Enabling this will affect ALL sliders, and can be enabled/disabled per slider with Slider::trailing_fill.

§handle_shape: HandleShape

Shape of the handle for sliders and similar widgets.

Changing this will affect ALL sliders, and can be enabled/disabled per slider with Slider::handle_shape.

§interact_cursor: Option<CursorIcon>

Should the cursor change when the user hovers over an interactive/clickable item?

This is consistent with a lot of browser-based applications (vscode, github all turn your cursor into CursorIcon::PointingHand when a button is hovered) but it is inconsistent with native UI toolkits.

§image_loading_spinners: bool

Show a spinner when loading an image.

§numeric_color_space: NumericColorSpace

How to display numeric color values.



impl Visuals


pub fn noninteractive(&self) -> &WidgetVisuals


pub fn text_color(&self) -> Color32


pub fn weak_text_color(&self) -> Color32


pub fn strong_text_color(&self) -> Color32


pub fn window_fill(&self) -> Color32

Window background color.


pub fn window_stroke(&self) -> Stroke


pub fn fade_out_to_color(&self) -> Color32

When fading out things, we fade the colors towards this.


pub fn gray_out(&self, color: Color32) -> Color32

Returned a “grayed out” version of the given color.


impl Visuals


pub fn dark() -> Self

Default dark theme.


pub fn light() -> Self

Default light theme.


impl Visuals


pub fn light_dark_radio_buttons(&mut self, ui: &mut Ui)

Show radio-buttons to switch between light and dark mode.


pub fn light_dark_small_toggle_button(&self, ui: &mut Ui) -> Option<Self>

Show small toggle-button for light and dark mode.


pub fn ui(&mut self, ui: &mut Ui)

Trait Implementations§


impl Clone for Visuals


fn clone(&self) -> Visuals

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

impl Debug for Visuals


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

Formats the value using the given formatter. Read more

impl Default for Visuals


fn default() -> Self

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

impl PartialEq for Visuals


fn eq(&self, other: &Visuals) -> 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.

impl StructuralPartialEq for Visuals

Auto Trait Implementations§

Blanket Implementations§


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


fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

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


fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

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


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

Mutably borrows from an owned value. Read more

impl<T> From<T> for T


fn from(t: T) -> T

Returns the argument unchanged.


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


fn into(self) -> U

Calls U::from(self).

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


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


type Owned = T

The resulting type after obtaining ownership.

fn to_owned(&self) -> T

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

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

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

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


type Error = Infallible

The type returned in the event of a conversion error.

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

Performs the conversion.

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.

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

Performs the conversion.

impl<T> SerializableAny for T
where T: 'static + Any + Clone + for<'a> Send + Sync,