DtWsmSetWorkspaceTitle(API)

okay so bestie, you're looking at DtWsmSetWorkspaceTitle from the API manual — yes, the whole page is about setting a workspace title, and it's lowkey iconic. Let's go 💅

✨ NAME ✨

DtWsmSetWorkspaceTitle — set workspace title. That's the whole vibe: it sets a workspace title, periodt.

🎀 SYNOPSIS 🎀

The signature is giving C function realness:

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

🌸 DESCRIPTION 🌸

The DtWsmSetWorkspaceTitle() function works with the CDE workspace manager, dtwm(1), and changes a specific workspace's title. Applications can use this function to implement an interface to the workspace manager. Slay.

If the DtWsmSetWorkspaceTitle() function is not successful, the most likely reason for failure is that the CDE workspace manager, dtwm(1), is not running. Also, DtWsmSetWorkspaceTitle() requires a widget. A gadget (or unrealized widget) is not acceptable for the widget argument.

bestie, not me trying to pass a gadget or an unrealized widget — don't do that. 🙈 A realized widget is the whole assignment.

DtWsmSetWorkspaceTitle() sends a message to the CDE workspace manager, dtwm(1), to set the title. If the workspace name is not valid, no action is taken and the workspace manager reports no error. Yep — silent no-op energy, no error, no drama. 💀

🦋 ARGUMENTS 🦋

• widget — a realized widget on the screen of interest.
• workspace — the name of the workspace (in X atom form) where the title should be set.
• title — the new title.

⭐ RETURN VALUE ⭐

The function returns Success (0) when it succeeds, and non-zero upon failure. Note that these are not the same values that _DtWsmSetWorkspaceTitle returns. Important!! Different function, different return values — iykyk. 😭

👑 SEE ALSO 👑

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

---

mwah 💋 — signed off at the bottom with DtWsmSetWorkspaceTitle(API), and that's the whole API manual page. Stay iconic, bestie 🫶✨