Struct leftwm_core::XWrap

pub struct XWrap {
    pub atoms: XAtom,
    pub managed_windows: Vec<Window>,
    pub tag_labels: Vec<String>,
    pub mode: Mode,
    pub focus_behaviour: FocusBehaviour,
    pub mouse_key_mask: ModMask,
    pub mode_origin: (i32, i32),
    pub task_notify: Arc<Notify>,
    pub motion_event_limiter: c_ulong,
    pub refresh_rate: c_short,
    /* private fields */
}

Contains Xserver information and origins.

Fields

atoms: XAtom

managed_windows: Vec<Window>

tag_labels: Vec<String>

mode: Mode

focus_behaviour: FocusBehaviour

mouse_key_mask: ModMask

mode_origin: (i32, i32)

task_notify: Arc<Notify>

motion_event_limiter: c_ulong

refresh_rate: c_short

Implementations

impl XWrap

pub fn get_all_windows(&self) -> Result<Vec<Window>, String>

Returns the child windows of all roots.

Errors

Will error if root has no windows or there is an error obtaining the root windows. See get_windows_for_root.

pub fn get_color(&self, color: String) -> c_ulong

Returns a XColor for a color.

pub fn get_cursor_point(&self) -> Result<(i32, i32), XlibError>

Returns the current position of the cursor.

Errors

Will error if root window cannot be found.

pub fn get_cursor_window(&self) -> Result<WindowHandle, XlibError>

Returns the current window under the cursor.

Errors

Will error if root window cannot be found.

pub const fn get_default_root_handle(&self) -> WindowHandle

Returns the handle of the default root.

pub const fn get_default_root(&self) -> Window

Returns the default root.

pub fn get_hint_sizing_as_xyhw(&self, window: Window) -> Option<XyhwChange>

Returns the WM_SIZE_HINTS/WM_NORMAL_HINTS of a window as a XyhwChange.

pub fn get_mask_event(&self) -> XEvent

Returns the next Xevent that matches the mask of the xserver.

pub fn get_next_event(&self) -> XEvent

Returns the next Xevent of the xserver.

pub fn get_screens(&self) -> Vec<Screen>

Returns all the screens of the display.

Panics

Panics if xorg cannot be contacted (xlib missing, not started, etc.) Also panics if window attrs cannot be obtained.

pub fn get_screens_area_dimensions(&self) -> (i32, i32)

Returns the dimensions of the screens.

pub fn get_transient_for(&self, window: Window) -> Option<Window>

Returns the transient parent of a window.

pub fn get_window_actions_atoms(&self, window: Window) -> Vec<Atom>

Returns the atom actions of a window.

pub fn get_window_attrs(
    &self,
    window: Window
) -> Result<XWindowAttributes, XlibError>

Returns the attributes of a window.

Errors

Will error if window status is 0 (no attributes).

pub fn get_window_class(&self, window: Window) -> Option<(String, String)>

Returns a windows class WM_CLASS

pub fn get_window_geometry(
    &self,
    window: Window
) -> Result<XyhwChange, XlibError>

Returns the geometry of a window as a XyhwChange struct.

Errors

Errors if Xlib returns a status of 0.

pub fn get_window_name(&self, window: Window) -> Option<String>

Returns a windows name.

pub fn get_window_legacy_name(&self, window: Window) -> Option<String>

Returns a WM_NAME (not _NETwindows name).

pub fn get_window_pid(&self, window: Window) -> Option<u32>

Returns a windows _NET_WM_PID.

pub fn get_window_states(&self, window: Window) -> Vec<WindowState>

Returns the states of a window.

pub fn get_window_states_atoms(&self, window: Window) -> Vec<Atom>

Returns the atom states of a window.

pub fn get_window_strut_array(&self, window: Window) -> Option<DockArea>

Returns structure of a window as a DockArea.

pub fn get_window_type(&self, window: Window) -> WindowType

Returns the type of a window.

pub fn get_wmhints(&self, window: Window) -> Option<XWMHints>

Returns the WM_HINTS of a window.

pub fn get_wm_state(&self, window: Window) -> Option<c_long>

Returns the WM_STATE of a window.

pub fn get_xatom_name(&self, atom: Atom) -> Result<String, XlibError>

Returns the name of a XAtom.

Errors

Errors if XAtom is not valid.

impl XWrap

pub fn grab_keys(&self, root: Window, keysym: u32, modifiers: u32)

Grabs the keysym with the modifier for a window.

pub fn reset_grabs(&self, keybinds: &[Keybind])

Resets the keybindings to a list of keybindings.

pub fn refresh_keyboard(&self, evt: &mut XMappingEvent) -> Result<(), XlibError>

Updates the keyboard mapping.

Errors

Will error if updating the keyboard failed.

pub fn keycode_to_keysym(&self, keycode: u32) -> XKeysym

Converts a keycode to a keysym.

pub fn keysym_to_keycode(&self, keysym: XKeysym) -> u32

Converts a keysym to a keycode.

impl XWrap

pub fn grab_mouse_clicks(&self, handle: Window, is_focused: bool)

Grabs the mouse clicks of a window.

pub fn grab_buttons(&self, window: Window, button: u32, modifiers: u32)

Grabs the button with the modifier for a window.

pub fn ungrab_buttons(&self, handle: Window)

Cleans all currently grabbed buttons of a window.

pub fn grab_pointer(&self, cursor: c_ulong)

Grabs the cursor and sets its visual.

pub fn ungrab_pointer(&self)

Ungrab the cursor.

pub fn move_cursor_to_window(&self, window: Window) -> Result<(), XlibError>

Move the cursor to a window.

Errors

Will error if unable to obtain window attributes. See get_window_attrs.

pub fn move_cursor_to_point(&self, point: (i32, i32)) -> Result<(), XlibError>

Move the cursor to a point.

Errors

Error indicates XlibError.

pub fn replay_click(&self, focused_window: Window, button: c_uint)

Replay a click on a window.

pub fn allow_pointer_events(&self)

Release the pointer if it is frozen.

impl XWrap

pub fn append_property_long(
    &self,
    window: Window,
    property: Atom,
    type: Atom,
    data: &[c_long]
)

Appends a window property.

pub fn replace_property_long(
    &self,
    window: Window,
    property: Atom,
    type: Atom,
    data: &[c_long]
)

Replaces a window property.

pub fn set_client_list(&self)

Sets the client list to the currently managed windows.

pub fn set_current_desktop(&self, current_tags: &[TagId])

Sets the current desktop.

pub fn set_desktop_prop(&self, data: &[u32], atom: c_ulong)

Sets a desktop property.

pub fn set_desktop_prop_c_ulong(
    &self,
    value: c_ulong,
    atom: c_ulong,
    type: c_ulong
)

Sets a desktop property with type c_ulong.

pub fn set_desktop_prop_string(
    &self,
    value: &str,
    atom: c_ulong,
    encoding: Atom
)

Sets a desktop property with type string.

pub fn set_state(&self, handle: WindowHandle, toggle_to: bool, atom: Atom)

Sets a windows state.

pub fn set_window_border_color(&self, window: Window, color: c_ulong)

Sets a windows border color.

pub fn set_window_config(
    &self,
    window: Window,
    window_changes: XWindowChanges,
    unlock: u32
)

Sets a windows configuration.

pub fn set_window_desktop(&self, window: Window, current_tags: &[TagId])

Sets what desktop a window is on.

pub fn set_window_states_atoms(&self, window: Window, states: &[Atom])

Sets the atom states of a window.

pub fn set_wm_states(&self, window: Window, states: &[c_long])

Sets the WM_STATE of a window.

impl XWrap

pub fn setup_window(&self, window: Window) -> Option<DisplayEvent>

Sets up a window before we manage it.

pub fn setup_managed_window(
    &mut self,
    h: WindowHandle,
    floating: bool,
    follow_mouse: bool
) -> Option<DisplayEvent>

Sets up a window that we want to manage.

pub fn teardown_managed_window(&mut self, h: &WindowHandle)

Teardown a managed window when it is destroyed.

pub fn update_window(&self, window: &Window)

Updates a window.

pub fn toggle_window_visibility(&self, window: Window, visible: bool)

Maps and unmaps a window depending on it is visible.

pub fn window_take_focus(&mut self, window: &Window, previous: Option<&Window>)

Makes a window take focus.

pub fn unfocus(&self, handle: Option<WindowHandle>, floating: bool)

Unfocuses all windows.

pub fn configure_window(&self, window: &Window)

Send a XConfigureEvent for a window to X.

pub fn change_window_attributes(
    &self,
    window: Window,
    mask: c_ulong,
    attrs: XSetWindowAttributes
)

Change a windows attributes.

pub fn restack(&self, handles: Vec<WindowHandle>)

Restacks the windows to the order of the vec.

pub fn move_resize_window(&self, window: Window, x: i32, y: i32, w: u32, h: u32)

pub fn move_to_top(&self, handle: &WindowHandle)

Raise a window.

pub fn kill_window(&self, h: &WindowHandle)

Kills a window.

pub fn force_unmapped(&mut self, window: Window)

Forcibly unmap a window.

pub fn subscribe_to_event(&self, window: Window, mask: c_long)

Subscribe to an event of a window.

pub fn subscribe_to_window_events(&self, window: Window)

Subscribe to the wanted events of a window.

impl XWrap

pub fn new() -> Self

Panics

Panics if unable to contact xorg.

pub fn load_config(
    &mut self,
    config: &impl Config,
    focused: Option<&Option<WindowHandle>>,
    windows: &[Window]
)

pub fn init(&mut self, config: &impl Config)

Initialize the xwrapper.

pub fn init_desktops_hints(&self)

EWMH support used for bars such as polybar.

Panics

Panics if a new Cstring cannot be formed

pub fn send_xevent(
    &self,
    window: Window,
    propogate: i32,
    mask: c_long,
    event: &mut XEvent
)

Send a xevent for a window to X.

pub fn load_colors(
    &mut self,
    config: &impl Config,
    focused: Option<&Option<WindowHandle>>,
    windows: Option<&[Window]>
)

Load the colors of our theme.

pub fn set_mode(&mut self, mode: Mode)

Sets the mode within our xwrapper.

pub async fn wait_readable(&mut self)

Wait until readable.

pub fn sync(&self)

Flush and sync the xserver.

pub fn flush(&self)

Flush the xserver.

pub fn queue_len(&self) -> i32

Returns how many events are waiting.

Trait Implementations

impl Default for XWrap

fn default() -> Self

Returns the “default value” for a type.