Built-in libDt Workspace Management Commands

DtWsmAddCurrentWorkspaceCallback variable widgetHandle ksh-command

Evaluates the specified kshell command whenever the user changes workspaces. The handle associated with this callback is returned in the environment variable indicated by variable. The widget indicated by widgetHandle should be a shell widget.

DtWsmRemoveWorkspaceCallback callbackHandle

Removes a workspace notification callback. When removing a workspace callback, you must pass in the callback handle that was returned when you registered the callback with DtWsmAddCurrentWorkspaceCallback.

DtWsmGetCurrentWorkspace display rootWindow variable

Returns the X atom that represents the user's current workspace in the environment variable indicated by variable. Use the XmGetAtomName command to map the X atom into its string representation.

DtWsmSetCurrentWorkspace widgetHandle workspaceNameAtom

Changes the user's current workspace to the workspace indicated by workspaceNameAtom.

Returns 0 if successful, 1 if unsuccessful.

DtWsmGetWorkspaceList display rootWindow variable

Returns a string of comma-separated X atoms, representing the current set of workspaces defined for the user, in the environment variable indicated by variable.

Returns 0 if successful, 1 if unsuccessful.

DtWsmGetWorkspacesOccupied display window variable

Returns a string of comma-separated X atoms, representing the current set of workspaces occupied by the indicated shell window in the environment variable indicated by variable.

Returns 0 if successful, 1 if unsuccessful.

DtWsmSetWorkspacesOccupied display window workspaceList

Moves the indicated shell window to the set of workspaces indicated by the string workspaceList, which must be a comma-separated list of X atoms.

DtWsmAddWorkspaceFunctions display window

Forces the Window Manager menu to include the functions used to move the window to other workspaces. This command only works if the window is in the withdrawn state.

DtWsmRemoveWorkspaceFunctions display window

Forces the Window Manager menu to not display the functions used to move the window to other workspaces; this prevents the window from being moved to any other workspaces. This command only works if the window is in the withdrawn state.

DtWsmOccupyAllWorkspaces display window

Requests that a window occupy all workspaces, including new workspaces, as they are created.

DtWsmGetCurrentBackdropWindows display rootWindow variable

Returns a string of comma-separated window IDs, representing the set of root backdrop windows.