Struct leftwm_core::XWrap

pub struct XWrap {
    pub atoms: XAtom,
    pub tags: Vec<String>,
    pub mode: Mode,
    pub focus_behaviour: FocusBehaviour,
    pub mouse_key_mask: ModMask,
    pub mode_origin: (i32, i32),
    pub task_notify: Arc<Notify>,
    // some fields omitted
}

Contains Xserver information and origins.

Fields

atoms: XAtom

tags: Vec<String>

mode: Mode

focus_behaviour: FocusBehaviour

mouse_key_mask: ModMask

mode_origin: (i32, i32)

task_notify: Arc<Notify>

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: &str) -> 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 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_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_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_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_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_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)

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, mod_mask: ModMask)

Replay a click on a window.

impl XWrap

pub fn set_client_list(&self)

Sets the client list to the currently managed windows.

pub fn set_current_desktop(&self, current_tags: &str)

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)

Sets a desktop property with type string.

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

Sets a window property.

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

Sets a windows state.

pub fn set_window_desktop(&self, window: Window, current_tags: &str)

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_managed_window(
    &mut self,
    h: WindowHandle,
    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, is_focused: bool, hide_offset: i32)

Updates a window.

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

Makes a window take focus.

pub fn unfocus(&self)

Unfocuses all windows.

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

Restacks the windows to the order of the vec.

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, handle: &WindowHandle)

Subscribe to the wanted events of a window.

impl XWrap

pub fn new() -> Self

Panics

Panics if unable to contact xorg.

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_config(&self, window: &Window)

Send a XConfigureEvent for a window to X.

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

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