Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

DtWsmAddWorkspaceModifiedCallbaDtWsmAddWorkspaceModifiedCallback(library call)

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  fol‐
       lows:

       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	 (con‐
       verted 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.

       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 func‐
       tion 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  con‐
       text to remove the callback.

SEE ALSO
       Dt/Wsm.h	  -  DtWsm(5),	dtwm(1),  DtWsmGetWorkspaceInfo(3),  DtWsmGet‐
       WorkspaceList(3), DtWsmRemoveWorkspaceCallback(3).

			       DtWsmAddWorkspaceModifiedCallback(library call)

Vote for polarhome