Phosphor
Qt6 / Wayland library suite for window-management tools
Loading...
Searching...
No Matches
PhosphorEngine::DesktopSpan Struct Reference

The contexts a window occupies, as the per-desktop membership pass reads them: which desktops (x11 numbering, the numbering the state keys use) and which activity. More...

#include <PhosphorEngine/EngineTypes.h>

Public Member Functions

bool coversDesktop (int desktop) const
 Whether the span reaches desktop desktop.
bool coversActivity (const QString &other) const
 Whether the span reaches activity other.
bool coversKey (const PlacementStateKey &key) const
 Whether the span reaches the context key names.

Public Attributes

bool known = false
 false: no desktop information yet — leave memberships alone
bool sticky = false
 on every desktop
QSet< int > desktops
 when !sticky: the desktops it occupies (a span such as {1,2})
QString activity
 empty: every activity, or unknown
QStringList activities {}
 When the window is on several (but not all) activities, all of them; empty otherwise.

Detailed Description

The contexts a window occupies, as the per-desktop membership pass reads them: which desktops (x11 numbering, the numbering the state keys use) and which activity.

known separates "on every desktop" from "the registry has not stamped a desktop yet". The two used to share one spelling (an empty set), and reading an unknown desktop as sticky adopted a window into every desktop the user visited. An unknown span adopts nothing and releases nothing.

Member Function Documentation

◆ coversActivity()

bool PhosphorEngine::DesktopSpan::coversActivity ( const QString & other) const
inline

Whether the span reaches activity other.

An empty activity on either side means "every activity" and never mismatches; a window on several activities reaches each of them.

◆ coversDesktop()

bool PhosphorEngine::DesktopSpan::coversDesktop ( int desktop) const
inline

Whether the span reaches desktop desktop.

◆ coversKey()

bool PhosphorEngine::DesktopSpan::coversKey ( const PlacementStateKey & key) const
inline

Whether the span reaches the context key names.

Member Data Documentation

◆ activities

QStringList PhosphorEngine::DesktopSpan::activities {}

When the window is on several (but not all) activities, all of them; empty otherwise.

Appended last (installed struct, F426).

◆ activity

QString PhosphorEngine::DesktopSpan::activity

empty: every activity, or unknown

◆ desktops

QSet<int> PhosphorEngine::DesktopSpan::desktops

when !sticky: the desktops it occupies (a span such as {1,2})

◆ known

bool PhosphorEngine::DesktopSpan::known = false

false: no desktop information yet — leave memberships alone

◆ sticky

bool PhosphorEngine::DesktopSpan::sticky = false

on every desktop


The documentation for this struct was generated from the following file: