kdk::WindowManager(3)

📦 version 3.0.1.2, in arch rolling, ubuntu resolute, ubuntu stonking

kdk::WindowManager 💅✨

okay bestie sit DOWN because this is kdk::WindowManager(3), straight out of the Library Functions Manual, and it's literally the class for doing stuff to windows. Group chat energy only, we're going through it together, no skipping 🫶

✨ NAME ✨

kdk::WindowManager — usually used for doing various operations on windows 🪟

that's it, that's the vibe. it's your window-handling bestie.

🌸 SYNOPSIS 🌸

#include <windowmanager.h>

Inherits QObject. yep, it's a QObject, so signals + slots, the whole main-character package 💖

🎀 Signals 🎀

every time the window world changes, this class is like "bestie I have NEWS" 📣

  • void windowAdded (const WindowId &windowId) — a window got added, the signal fires 🎉
  • void windowRemoved (const WindowId &windowId) — a window got removed, rip 🫡
  • void activeWindowChanged (const WindowId &wid) — the active window changed, focus has moved 💫
  • void windowChanged (const WindowId &wid) — the window changed, something about it shifted
  • void currentDesktopChanged () — the current desktop changed, we moved rooms 🚪
  • void isShowingDesktopChanged () — the desktop showing state changed, show/hide vibes 👀
  • void titleChanged (const WindowId &wid) — the window title changed ✍️
  • void iconChanged (const WindowId &wid) — the window icon changed 🖼️
  • void activeChanged (const WindowId &wid) — the window active state changed ⚡
  • void fullscreenChanged (const WindowId &wid) — the window fullscreen state changed 🖥️
  • void keepAboveChanged (const WindowId &wid) — the window keep-above state changed, floating on top now 💅
  • void minimizedChanged (const WindowId &wid) — the window minimized state changed 📥
  • void maximizedChanged (const WindowId &wid) — the window maximized state changed 📐
  • void onAllDesktopsChanged (const WindowId &wid) — onAllDesktopsChanged, that's the whole blurb, it said what it said 💀
  • void demandsAttentionChanged (const WindowId &wid) — the demandsAttention state changed, window is yelling for you 📢
  • void skipTaskbarChanged (const WindowId &wid) — the skip-taskbar state changed 🙈
  • void skipSwitcherChanged (const WindowId &wid) — the skip-window-switcher state changed 🌀
  • void geometryChanged (const WindowId &wid) — the window geometry changed, it moved 📍
  • void outputInfoChanged (OutputInfo *) — the output (screen) info changed 🖥️✨

🔥 Static Public Member Functions 🔥

all of these are static, so you don't even need an instance, just call them like the icon you are 👑

  • static WindowManager * self () — self, no description given, it's just there being mysterious 🫧
  • static WindowInfo getwindowInfo (const WindowId &windowId) — get the window info 📋
  • static WindowId currentActiveWindow () — get the current active window 🎯
  • static void keepWindowAbove (const WindowId &windowId) — keep the window above / pin it on top 📌
  • static QString getWindowTitle (const WindowId &windowId) — get the window title 🏷️
  • static QIcon getWindowIcon (const WindowId &windowId) — get the window icon 🎨
  • static QString getWindowGroup (const WindowId &windowId) — get the group name of the group the window is in 👯
  • static void closeWindow (const WindowId &windowId) — close the window 🚪💨
  • static void activateWindow (const WindowId &windowId) — activate the window ⚡
  • static void maximizeWindow (const WindowId &windowId) — maximize the window 📐
  • static void minimizeWindow (const WindowId &windowId) — minimize the window 📥
  • static quint32 getPid (const WindowId &windowId) — get the window's process pid 🔢
  • static void showDesktop () — show the current desktop 🖼️
  • static void hideDesktop () — un-show (hide) the current desktop 🙈
  • static QString currentDesktop () — get the name of the current desktop 🏷️
  • static QList< WindowId > windows () — get the current window list 📃
  • static NET::WindowType getWindowType (const WindowId &windowId) — get the window type. ⚠️ only applies in the X environment; under Wayland it uniformly returns normal (so don't come for it, it's just built like that)
  • static void setGeometry (QWindow *window, const QRect &rect) — set the window geometry/position 📍
  • static void setSkipTaskBar (QWindow *window, bool skip) — set whether to skip the taskbar 🙈
  • static void setSkipSwitcher (QWindow *window, bool skip) — set whether to skip the window switcher 🌀
  • static bool skipTaskBar (const WindowId &windowId) — check whether the window skips the taskbar ✅
  • static bool skipSwitcher (const WindowId &windowId) — check whether the window skips the window switcher ✅
  • static bool isShowingDesktop () — check whether the desktop is in the showing state ✅
  • static void setOnAllDesktops (const WindowId &windowId) — set the window to show on all desktops 🌐
  • static bool isOnAllDesktops (const WindowId &windowId) — check whether the window shows on all desktops ✅
  • static bool isOnCurrentDesktop (const WindowId &id) — check whether the window is on the current desktop ✅
  • static bool isOnDesktop (const WindowId &id, int desktop) — check whether the window is on the specified desktop ✅
  • static void setPanelTakefocus (QWindow *window, bool flag) — set whether a panel-property window takes focus. ⚠️ only takes effect in the Wayland environment
  • static void demandAttention (const WindowId &wid) — send the demandAttention state 📢
  • static QString getProcessName (const WindowId &windowId) — get the process name the window belongs to 🏷️
  • static void setWindowRadius (QWindow *window, int radius) — setWindowRadius, no blurb given, it's giving mystery 💅
  • static void activateWindow (QWindow *window1, QWindow *window2) — activateWindow, another overload, still no blurb 🫧
  • static QRect windowGeometry (const WindowId &windowId) — windowGeometry, no description, iconic behavior honestly
  • static void setPanelAutoHide (QWindow *window, bool autoHide) — setPanelAutoHide, that's all it says 🎀
  • static void setGrabKeyboard (QWindow *window, bool grabKeyboard) — setGrabKeyboard, no notes, just vibes ⌨️
  • static void setWindowLayer (QWindow *window, WindowLayer layer) — setWindowLayer, no blurb 🗂️
  • static WindowLayer windowLayer (QWindow *window) — windowLayer, also no blurb 🗂️
  • static void setHighlight (const WindowId &wid, bool highlight) — setHighlight, no description ✨
  • static bool isHightlight (const WindowId &wid) — isHightlight, yes that spelling, keep it, no description 💀
  • static void setOpenUnderCursor (QWindow *window) — setOpenUnderCursor, no blurb 🖱️
  • static void setOpenUnderCursor (QWindow *window, int x, int y) — setOpenUnderCursor, the x/y overload, still no blurb 🖱️
  • static void setIconName (QWindow *window, const QString &iconName) — setIconName, no blurb 🎨
  • static QString currentSeatName () — currentSeatName, no description 🪑
  • static QString currentOutputName () — currentOutputName, no description 🖥️
  • static QList< OutputInfo * > outputsInfo () — outputsInfo, no description 📊
  • static QList< WindowId > getWindowIdByPid (quint32 pid) — getWindowIdByPid, no description 🔍
  • static QList< WindowId > getWindowIdByTtile (const QString &title) — getWindowIdByTtile, yes that spelling too, no description 🔍

💖 Detailed Description 💖

usually used for doing various operations on windows 🪟 — yeah, same as the NAME section said, because it's the truth and it bears repeating.

⭐ Since ⭐

1.2.0 — been here since 1.2.0, a whole legend 🫶

and that's where part 1 leaves us bestie… the page keeps going 👀

💖 Member Function Documentation 💖

okay bestie, this is the big one. every single member function of kdk::WindowManager, in the exact order the docs gave them, nothing skipped, nothing merged. grab a snack, we're going in 🌸

✨ activateWindow (the WindowId one)

static void kdk::WindowManager::activateWindow (const WindowId & windowId)

static, so it's a class-level baddie — no instance required 💅

  • Parameters: windowId — the window you're bringing to the front. 激活窗口 energy, literally.

✨ activateWindow (the two-QWindow one)

static void kdk::WindowManager::activateWindow (QWindow * window1, QWindow * window2)
  • Since: 2.5.1.0
  • Parameters:
    • window1
    • window2

📣 activeChanged (signal)

void kdk::WindowManager::activeChanged (const WindowId & wid)

the "窗口活动状态改变" signal — a window's active state just changed, tell the group chat 🔔

  • Since: 2.3.1.0
  • Parameters: wid

📣 activeWindowChanged (signal)

void kdk::WindowManager::activeWindowChanged (const WindowId & wid)

the "活动窗口改变" signal — the active window changed. main character swapped, periodt 👑

  • Parameters: wid

🚪 closeWindow

static void kdk::WindowManager::closeWindow (const WindowId & windowId)

关闭窗口 — shut it down, bye bestie 🫶 static.

  • Parameters: windowId

🎯 currentActiveWindow

static WindowId kdk::WindowManager::currentActiveWindow ()

获取当前活动窗口 — hands you the current active window as a WindowId 💖

  • Returns: the current active window.

🖥️ currentDesktop

static QString kdk::WindowManager::currentDesktop ()

获取当前桌面的名称 — the name of the current desktop, as a QString ✨

  • Returns: the current desktop's name.

📣 currentDesktopChanged (signal)

void kdk::WindowManager::currentDesktopChanged ()

当前桌面改变信号 — the current desktop changed, sound the alarm 🚨

  • Parameters: wid
the doc lists a parameter wid here even though the signature takes none — that's just how the page reads, bestie 🙈

🖥️ currentOutputName

static QString kdk::WindowManager::currentOutputName ()
  • Since: 2.5.1.0
  • Returns: the current output name.

💺 currentSeatName

static QString kdk::WindowManager::currentSeatName ()
  • Since: 2.5.1.0
  • Returns: the current seat name.

🙋 demandAttention

static void kdk::WindowManager::demandAttention (const WindowId & wid)

发送 demandAttention 状态 — fires off the demandAttention state, like waving both hands in class 🙋‍♀️

  • Since: 2.3.1.0
  • Parameters: wid

📣 demandsAttentionChanged (signal)

void kdk::WindowManager::demandsAttentionChanged (const WindowId & wid)

demandsAttention 状态改变信号 — the demandsAttention state changed 🔔

  • Since: 2.3.1.0
  • Parameters: wid

📣 fullscreenChanged (signal)

void kdk::WindowManager::fullscreenChanged (const WindowId & wid)

窗口全屏状态改变信号 — the window's fullscreen state changed. it's giving fullscreen 🌈

  • Since: 2.3.1.0
  • Parameters: wid

📣 geometryChanged (signal)

void kdk::WindowManager::geometryChanged (const WindowId & wid)

窗口位置改变信号 — the window's position changed 📐

  • Since: 2.3.1.0
  • Parameters: wid

🆔 getPid

static quint32 kdk::WindowManager::getPid (const WindowId & windowId)

获取窗口进程 pid — the pid of the window's process, as a quint32 🔢

  • Returns: the pid.

🏷️ getProcessName

static QString kdk::WindowManager::getProcessName (const WindowId & windowId)

获取窗口所属的进程名称 — the name of the process the window belongs to 💖

  • Since: 2.3.1.0
  • Parameters: windowId
  • Returns: the process name.

👯 getWindowGroup

static QString kdk::WindowManager::getWindowGroup (const WindowId & windowId)

获取窗口所在组的组名 — the group name of the group the window is in. found family fr fr 🫂

  • Parameters: windowId
  • Returns: the group name.

🖼️ getWindowIcon

static QIcon kdk::WindowManager::getWindowIcon (const WindowId & windowId)

获取窗口图标 — the window's icon, as a QIcon ✨

  • Parameters: windowId
  • Returns: the icon.

🆔 getWindowIdByPid

static QList< WindowId > kdk::WindowManager::getWindowIdByPid (quint32 pid)
  • Since: 2.5.1.0
  • Returns: a QList< WindowId > for that pid.

🆔 getWindowIdByTtile

static QList< WindowId > kdk::WindowManager::getWindowIdByTtile (const QString & title)

(yes, Ttile — that's the real spelling, we don't fix it, we respect it 💅)

  • Since: 2.5.1.0
  • Returns: a QList< WindowId > matching that title.

🗂️ getwindowInfo

static WindowInfo kdk::WindowManager::getwindowInfo (const WindowId & windowId)

获取窗口信息 — the window's info, bundled up as a WindowInfo 🎀

  • Parameters: windowId
  • Returns: the WindowInfo.

📛 getWindowTitle

static QString kdk::WindowManager::getWindowTitle (const WindowId & windowId)

获取窗口标题 — the window's title 📛

  • Parameters: windowId
  • Returns: the title.

🪟 getWindowType

static NET::WindowType kdk::WindowManager::getWindowType (const WindowId & windowId)

获取窗口类型，仅适用于 X 环境下，wayland 下统一返回 normal — the window type, but heads up bestie: this only works under X, and under Wayland it uniformly returns normal ⚠️

  • Parameters: windowId
  • Returns: the NET::WindowType.

📣 iconChanged (signal)

void kdk::WindowManager::iconChanged (const WindowId & wid)

窗口图标改变信号 — the window icon changed 🖼️

  • Since: 2.3.1.0
  • Parameters: wid

✨ isHightlight

static bool kdk::WindowManager::isHightlight (const WindowId & wid)

(yep, Hightlight — the original spelling, untouched, iconic in its own way 🌟)

  • Since: 2.5.1.0
  • Parameters: wid

🖥️ isOnAllDesktops

static bool kdk::WindowManager::isOnAllDesktops (const WindowId & windowId)

判断窗口在所有桌面中显示 — is this window showing on all desktops? yes/no bestie 🫶

  • Since: 2.0.2.1
  • Parameters: windowId
  • Returns: bool.

🖥️ isOnCurrentDesktop

static bool kdk::WindowManager::isOnCurrentDesktop (const WindowId & id)

判断窗口是否在当前桌面 — is the window on the current desktop?

  • Parameters: 窗口id (the window id)
  • Since: 2.1.1.0
  • Returns: bool.

🖥️ isOnDesktop

static bool kdk::WindowManager::isOnDesktop (const WindowId & id, int desktop)

判断窗口是否在指定桌面 — is the window on the specified desktop?

  • Parameters:
    • 窗口id (the window id)
    • 桌面id (the desktop id)
  • Since: 2.1.1.0
  • Returns: bool.

👀 isShowingDesktop

static bool kdk::WindowManager::isShowingDesktop ()

判断桌面是否处于显示状态 — is the desktop in the showing state?

  • Since: 2.0.2.1
  • Returns: bool.

📣 keepAboveChanged (signal)

void kdk::WindowManager::keepAboveChanged (const WindowId & wid)

窗口置顶状态改变信号 — the window's keep-above state changed ⬆️

  • Since: 2.3.1.0
  • Parameters: wid

⬆️ keepWindowAbove

static void kdk::WindowManager::keepWindowAbove (const WindowId & windowId)

置顶窗口 — keep the window above, queen behaviour 👑

  • Parameters: windowId

📣 maximizedChanged (signal)

void kdk::WindowManager::maximizedChanged (const WindowId & wid)

窗口最大化状态改变信号 — the window's maximized state changed 🔲

  • Since: 2.3.1.0
  • Parameters: wid

🔲 maximizeWindow

static void kdk::WindowManager::maximizeWindow (const WindowId & windowId)

最大化窗口 — maximize the window, take up all the space, main character energy 💅

  • Parameters: windowId

📣 minimizedChanged (signal)

void kdk::WindowManager::minimizedChanged (const WindowId & wid)

窗口最小化状态改变信号 — the window's minimized state changed ➖

  • Since: 2.3.1.0
  • Parameters: wid

➖ minimizeWindow

static void kdk::WindowManager::minimizeWindow (const WindowId & windowId)

最小化窗口 — minimize the window, nap time 😴

  • Parameters: windowId

📣 onAllDesktopsChanged (signal)

void kdk::WindowManager::onAllDesktopsChanged (const WindowId & wid)
  • Since: 2.3.1.0
  • Parameters: wid

📣 outputInfoChanged (signal)

void kdk::WindowManager::outputInfoChanged (OutputInfo *)

屏幕信息改变信号 — screen info changed 🖥️✨

  • Since: 2.5.1.0

🖥️ outputsInfo

static QList< OutputInfo * > kdk::WindowManager::outputsInfo ()
  • Since: 2.5.1.0
  • Returns: a QList< OutputInfo * >.

🪞 self

static WindowManager * kdk::WindowManager::self ()
  • Returns: a WindowManager *.

📐 setGeometry

static void kdk::WindowManager::setGeometry (QWindow * window, const QRect & rect)

设置窗口位置 — set the window's position 📐

  • Parameters:
    • window
    • rect

⌨️ setGrabKeyboard

static void kdk::WindowManager::setGrabKeyboard (QWindow * window, bool grabKeyboard)
  • Since: 2.5.1.0
  • Parameters:
    • window
    • grabKeyboard

🌟 setHighlight

static void kdk::WindowManager::setHighlight (const WindowId & wid, bool highlight)
  • Since: 2.5.1.0
  • Parameters:
    • wid
    • highlight

🏷️ setIconName

static void kdk::WindowManager::setIconName (QWindow * window, const QString & iconName)
  • Since: 2.5.1.0
  • Parameters:
    • window
    • iconName

🖥️ setOnAllDesktops

static void kdk::WindowManager::setOnAllDesktops (const WindowId & windowId)

设置窗口在所有桌面中显示 — set the window to show on all desktops ✨

  • Since: 2.0.2.1
  • Parameters: wid
yep, the signature says windowId and the parameter list says wid — both are exactly as written, no cap 🙈

🖱️ setOpenUnderCursor

static void kdk::WindowManager::setOpenUnderCursor (QWindow * window)
  • Since: 2.5.1.0
  • Parameters: window

🖱️ setOpenUnderCursor (the one with coordinates)

static void kdk::WindowManager::setOpenUnderCursor (QWindow * window, int x, int y)
  • Since: 2.5.1.0
  • Parameters:
    • window
    • x
    • y

🫥 setPanelAutoHide

static void kdk::WindowManager::setPanelAutoHide (QWindow * window, bool autoHide)
  • Since: 2.5.1.0
  • Parameters:
    • window
    • autoHide

🎯 setPanelTakefocus

static void kdk::WindowManager::setPanelTakefocus (QWindow * window, bool flag)

设置 panel 属性窗体是否获取焦点，仅 wayland 环境下生效 — sets whether the panel-attribute window takes focus; only takes effect in a Wayland environment ⚠️

  • Since: 2.3.1.0
  • Parameters:
    • window
    • flag

⏭️ setSkipSwitcher

static void kdk::WindowManager::setSkipSwitcher (QWindow * window, bool skip)

设置是否跳过窗口选择 — set whether to skip the window switcher

  • Since: 2.0.2.1
  • Parameters:
    • window
    • skip

⏭️ setSkipTaskBar

static void kdk::WindowManager::setSkipTaskBar (QWindow * window, bool skip)

设置是否跳过任务栏 — set whether to skip the taskbar

  • Since: 2.0.2.1
  • Parameters:
    • window
    • skip

🗂️ setWindowLayer

static void kdk::WindowManager::setWindowLayer (QWindow * window, WindowLayer layer)
  • Since: 2.5.1.0
  • Parameters:
    • window
    • layer

🎀 setWindowRadius

static void kdk::WindowManager::setWindowRadius (QWindow * window, int radius)
  • Since: 2.5.1.0
  • Parameters:
    • window
    • radius

⏭️ skipSwitcher

static bool kdk::WindowManager::skipSwitcher (const WindowId & windowId)

判断窗体是否跳过窗口选择 — does this window skip the window switcher?

  • Since: 2.0.2.1
  • Parameters: windowId
  • Returns: bool.

📣 skipSwitcherChanged (signal)

void kdk::WindowManager::skipSwitcherChanged (const WindowId & wid)

跳过窗口选择器状态改变信号 — the skip-window-switcher state changed 🔔

  • Since: 2.3.1.0
  • Parameters: wid

⏭️ skipTaskBar

static bool kdk::WindowManager::skipTaskBar (const WindowId & windowId)

判断窗体是否跳过任务栏 — does this window skip the taskbar?

  • Since: 2.0.2.1
  • Parameters: windowId
  • Returns: bool.

📣 skipTaskbarChanged (signal)

void kdk::WindowManager::skipTaskbarChanged (const WindowId & wid)

跳过任务栏状态改变信号 — the skip-taskbar state changed 🔔

  • Since: 2.3.1.0
  • Parameters: wid

📣 titleChanged (signal)

void kdk::WindowManager::titleChanged (const WindowId & wid)

窗口标题改变信号 — the window title changed 📛

  • Since: 2.3.1.0
  • Parameters: wid

📣 windowAdded (signal)

void kdk::WindowManager::windowAdded (const WindowId & windowId)

窗口添加信号 — a window was added 🎉

  • Parameters: windowId

📣 windowChanged (signal)

void kdk::WindowManager::windowChanged (const WindowId & wid)

窗口改变信号 — a window changed 🔄

  • Parameters: wid

📐 windowGeometry

static QRect kdk::WindowManager::windowGeometry (const WindowId & windowId)
  • Since: 2.5.1.0
  • Parameters: windowId
  • Returns: a QRect.

🗂️ windowLayer

static WindowLayer kdk::WindowManager::windowLayer (QWindow * window)
  • Since: 2.5.1.0
  • Parameters: window
  • Returns: a WindowLayer.

📣 windowRemoved (signal)

void kdk::WindowManager::windowRemoved (const WindowId & windowId)

窗口删除信号 — a window was removed 👋

  • Parameters: windowId

🪟 windows

static QList< WindowId > kdk::WindowManager::windows ()

获取当前窗口列表 — the current window list 🌈

  • Returns: a QList< WindowId >.

📝 Author 📝

Generated automatically by Doxygen for LIBKYSDK-APPLICATIONS from the source code.

and that's a wrap on the whole page, bestie 🫶 this one was generated automatically by Doxygen for LIBKYSDK-APPLICATIONS straight from the source code, it's Version version:3.0, and it lives its life as the manual page kdk::WindowManager(3). ate and left no crumbs 💅✨🎀

📦 where this page comes from