DTWSMSETCURRENTWORKSPACE(3)

💫 NAME 💫

okay bestie, this is the DtWsmSetCurrentWorkspace(library call) page — it's literally about setting the current workspace 💅

🌸 SYNOPSIS 🌸

#include &<Dt/Wsm.h>
int DtWsmSetCurrentWorkspace(
       Widget widget,
       Atom aWorkspace);

✨ DESCRIPTION ✨

The DtWsmSetCurrentWorkspace function works with the XCDE workspace manager, dtwm(1), and sets the current workspace. Applications can use this function to switch from the current workspace to another workspace. slay 🫶

The widget argument is a realized widget on the screen of interest. no cap.

The aWorkspace argument is the name — in X atom form — of the workspace to be made current. yep, atom form, iykyk ✨

💖 RETURN VALUE 💖

Upon successful completion, the DtWsmSetCurrentWorkspace function returns Success; otherwise, it returns a value not equal to Success. simple as that, bestie 💀

🎀 APPLICATION USAGE 🎀

If the DtWsmSetCurrentWorkspace function is not successful, the most likely reason for failure is that the XCDE workspace manager, dtwm(1), is not running. lowkey the vibe check failed because dtwm(1) wasn't there 😭

The DtWsmSetCurrentWorkspace function requires a widget. A gadget is not acceptable for the widget argument. not me stressing this, but fr fr: widget yes, gadget no 🙈

DtWsmSetCurrentWorkspace sends a message to the XCDE workspace manager, dtwm(1), to switch workspaces. If the workspace name is not valid, no action is taken and the workspace manager reports no error. iconic behavior, honestly — invalid name, no switch, no error report 💀

⚠️ bestie, remember: no valid workspace name = no action, and the workspace manager reports no error. don't expect a dramatic error message, because it's giving silence 🌸

🦋 SEE ALSO 🦋

• Dt/Wsm.h - DtWsm(5), dtwm(1), DtWsmGetCurrentWorkspace(3).

---

🎀 and that's the whole page, bestie — footer energy is just DtWsmSetCurrentWorkspace(library call), so we're signing off from the library-call corner of the manual 💖