DtWsmAddCurrentWorkspaceCallbaDctkW(slmiAbdrdaCruyrrceanltlW)orkspaceCallback(library call)
NAME [Toc] [Back]
DtWsmAddCurrentWorkspaceCallback - add a callback to be called when
the current workspace changes
SYNOPSIS [Toc] [Back]
#include <Dt/Wsm.h>
DtWsmCBContext DtWsmAddCurrentWorkspaceCallback(
Widget widget,
DtWsmWsChangeProc ws_change,
Pointer client_data);
DESCRIPTION [Toc] [Back]
The DtWsmAddCurrentWorkspaceCallback function registers an application
function to be called when the CDE workspace manager, dtwm(1),
switches to a new workspace.
The workspace manager sends the new current workspace name to the
DtWsmWsChangeProc callback.
The widget argument is a realized widget.
The ws_change argument is the procedure to be called when the
workspace changes.
The client_data argument points to arbitrary client data to be passed
back to ws_change.
The header defines the DtWsmWsChangeProc callback prototype as
follows:
typedef void (*DtWsmWsChangeProc)(Widget widget,
Atom aWorkspace,
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 client_data argument points to the client data to be registered
with the callback.
RETURN VALUE [Toc] [Back]
Upon successful completion, the DtWsmAddCurrentWorkspaceCallback
function returns a workspace callback registration context.
APPLICATION USAGE [Toc] [Back]
The DtWsmAddCurrentWorkspaceCallback function returns a registration
context that the application must save in order to remove this
callback later. DtWsmAddCurrentWorkspaceCallback requires a window;
- 1 - Formatted: January 24, 2005
DtWsmAddCurrentWorkspaceCallbaDctkW(slmiAbdrdaCruyrrceanltlW)orkspaceCallback(library call)
thus, a gadget is not acceptable for the widget argument. The
DtWsmRemoveWorkspaceCallback(3) function needs a registration context
to remove the callback.
SEE ALSO [Toc] [Back]
Dt/Wsm.h - DtWsm(5), dtwm(1), DtWsmRemoveWorkspaceCallback(3).
- 2 - Formatted: January 24, 2005 [ Back ] |
