DtWsmAddWorkspace(API)

💖 NAME 💖

okay bestie, welcome to the DtWsmAddWorkspace(API) manual page — the manual name is right there, and the NAME section is literally DtWsmAddWorkspace — add a workspace ✨

🫶 SYNOPSIS 🫶

#include &<Dt/Wsm.h>
int DtWsmAddWorkspace(
Widget widget,
char *title);

🌸 DESCRIPTION 🌸

okay so DtWsmAddWorkspace() is besties with the CDE workspace manager, dtwm(1), and it adds a new workspace. Applications can use this function to implement an interface to the workspace manager. periodt 💅

If DtWsmAddWorkspace() is not successful, the most likely reason for failure is that the CDE workspace manager, dtwm(1), is not running. not me being dramatic, just keeping it real 😭

DtWsmAddWorkspace() sends a message to the CDE workspace manager, dtwm(1), to add the workspace. lowkey simple, highkey iconic 💖

🎀 ARGUMENTS 🎀

• widget — a realized widget. yes, realized is the word, bestie ✨
• title — a user visible title for the new workspace. make it cute, make it visible 🎀

👑 RETURN VALUE 👑

The function returns Success (0) when it succeeds, and non-zero upon failure. so 0 is the slay outcome, anything else is the vibe check failing 💀

🦋 SEE ALSO 🦋

• DtWsm(5)
• "Communicating with the Workspace Manager" section in the CDE Programmer's Guide
• "Workspace Manager" section in the CDE Programmer's Overview

---

and that's the page, bestie! The footer had no source/version/date deets for me to spill — just the page name — so here's the cute sign-off: stay hydrated, keep your widgets realized, and bye 💖✨