DtWsmAddWorkspaceMUNIXiSystemDtWsmAddWorkspaceModifiedCallback(3)
NAME
DtWsmAddWorkspaceModifiedCallback - add a callback to be
called when any workspace is changed
SYNOPSIS
#include <Dt/Wsm.h>
DtWsmCBContext
DtWsmAddWorkspaceModifiedCallback(Widget widget,
DtWsmWsModifiedProc ws_change,
Pointer client_data);
DESCRIPTION
The DtWsmAddWorkspaceModifiedCallback() function works with
the CDE workspace manager, dtwm(1), and registers a function
to be called when a workspace is added, deleted or modified.
The widget argument is a realized widget.
The ws_change argument is the procedure to be called when a
workspace is modified.
The client_data argument points to arbitrary client data to
be passed back to ws_change.
The header defines the DtWsmWsModifiedProc callback
prototype as follows:
typedef void (*DtWsmWsModifiedProc)(Widget widget,
Atom aWorkspace,
DtWsmWsReason reason,
Pointer client_data);
The widget argument is the ID of the widget to be registered
with the callback.
The aWorkspace argument is the name of the new current
workspace (converted to an X atom).
The reason argument is a type of modification:
DtWSM_REASON_ADD
A new workspace was added.
DtWSM_REASON_BACKDROP
The backdrop for the workspace changed.
DtWSM_REASON_CURRENT
A different workspace was made the current
workspace.
DtWSM_REASON_DELETE
A workspace was deleted.
Page 1 (printed 9/3/04)
DtWsmAddWorkspaceMUNIXiSystemDtWsmAddWorkspaceModifiedCallback(3)
DtWSM_REASON_TITLE
The workspace title changed.
The client_data argument points to the client data to be
registered with the callback.
RETURN VALUE
Upon successful completion, the
DtWsmAddWorkspaceModifiedCallback() function returns a
workspace callback registration context.
APPLICATION USAGE
The DtWsmAddWorkspaceModifiedCallback() function returns a
registration context that the application must save in order
to remove this callback later.
DtWsmAddWorkspaceModifiedCallback() requires a window; thus,
a gadget is not acceptable for the widget argument.
The DtWsmRemoveWorkspaceCallback(3) function needs a
registration context to remove the callback.
SEE ALSO
DtWsm(5), dtwm(1), DtWsmGetWorkspaceInfo(3),
DtWsmGetWorkspaceList(3), DtWsmRemoveWorkspaceCallback(3).
Page 2 (printed 9/3/04)
