Struct SystemStyle 

#[repr(C)]
pub struct SystemStyle {

    pub fonts: SystemFonts,
    pub metrics: SystemMetrics,
    pub linux: LinuxCustomization,
    pub platform: Platform,
    pub focus_visuals: FocusVisuals,
    pub language: AzString,
    pub app_specific_stylesheet: Option<Box<Css>>,
    pub scrollbar: Option<Box<ComputedScrollbarStyle>>,
    pub scroll_physics: ScrollPhysics,
    pub theme: Theme,
    pub os_version: OsVersion,
    pub prefers_reduced_motion: BoolCondition,
    pub prefers_high_contrast: BoolCondition,
    pub accessibility: AccessibilitySettings,
    pub input: InputMetrics,
    pub text_rendering: TextRenderingHints,
    pub scrollbar_preferences: ScrollbarPreferences,
    pub visual_hints: VisualHints,
    pub animation: AnimationMetrics,
    pub colors: SystemColors,
    pub icon_style: IconStyleOptions,
    pub audio: AudioMetrics,
}

A unified collection of discovered system style properties.

Fields

fonts: SystemFonts

metrics: SystemMetrics

linux: LinuxCustomization

Linux-specific customisation (icon theme, cursor theme, GTK theme, …)

platform: Platform

focus_visuals: FocusVisuals

Focus ring / indicator visual style

language: AzString

System language/locale in BCP 47 format (e.g., “en-US”, “de-DE”) Detected from OS settings at startup

app_specific_stylesheet: Option<Box<Css>>

An optional, user-provided stylesheet loaded from a conventional location (~/.config/azul/styles/<app_name>.css), allowing for application-specific “ricing”. Only loaded when the “io” feature is enabled and AZ_RICING is not set to off.

scrollbar: Option<Box<ComputedScrollbarStyle>>

Scrollbar style information (boxed to ensure stable FFI size)

scroll_physics: ScrollPhysics

Global scroll physics configuration (momentum, friction, rubber-banding). Platform-specific defaults are applied during system style discovery. Applications can override this to change the “feel” of scrolling globally.

theme: Theme

os_version: OsVersion

Detected OS version (e.g., Windows 11 22H2, macOS Sonoma, etc.)

prefers_reduced_motion: BoolCondition

User prefers reduced motion (accessibility setting)

prefers_high_contrast: BoolCondition

User prefers high contrast (accessibility setting)

accessibility: AccessibilitySettings

Detailed accessibility settings (superset of prefers_reduced_motion / prefers_high_contrast)

input: InputMetrics

Input interaction timing / distance thresholds from the OS

text_rendering: TextRenderingHints

Text rendering / anti-aliasing hints from the OS

scrollbar_preferences: ScrollbarPreferences

OS-level scrollbar visibility / click-behaviour preferences

visual_hints: VisualHints

Visual hints: icons in menus/buttons, toolbar style, tooltips

animation: AnimationMetrics

Animation enable/disable, speed factor, focus indicator behaviour

colors: SystemColors

icon_style: IconStyleOptions

Icon-specific styling options (grayscale, tinting, etc.)

audio: AudioMetrics

Audio feedback preferences (event sounds, input sounds)

Implementations

impl SystemStyle

pub fn to_json_string(&self) -> AzString

Format the SystemStyle as a human-readable JSON string for debugging.

This does NOT use serde — it manually formats the most important fields so that they can be verified against OS-reported values in a test script.

pub fn detect() -> Self

Returns a platform-appropriate default system style.

This returns hard-coded defaults based on the target OS. For actual runtime detection of the user’s theme, colors, and fonts, use the platform discovery in azul-dll (called automatically by App::create()).

pub fn default_for_platform() -> Self

Returns hard-coded defaults for the current compile-time platform.

pub fn new() -> Self

Alias for detect - kept for internal compatibility, not exposed in FFI.

pub fn create_csd_stylesheet(&self) -> Css

Create a CSS stylesheet for CSD (Client-Side Decorations) titlebar

This generates CSS rules for the CSD titlebar using system colors, fonts, and metrics to match the native platform look. Returned rules carry rule_priority::SYSTEM.

Trait Implementations

impl Clone for SystemStyle

fn clone(&self) -> SystemStyle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SystemStyle

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

Formats the value using the given formatter.

impl Default for SystemStyle

fn default() -> SystemStyle

Returns the “default value” for a type.

impl PartialEq for SystemStyle

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for SystemStyle