[ новости /+++ | форум | теги | ]

NAME
     DtWsmGetWorkspacesOccupied - get the workspaces in  which  a
     window resides

SYNOPSIS
     #include <Dt/Wsm.h>
     Status DtWsmGetWorkspacesOccupied(Display *display,
                                       Window window,
                                       Atom **ppaWorkspaces,
                                       int *pNumWs);

DESCRIPTION
     The DtWsmGetWorkspacesOccupied() function works with the CDE
     workspace   manager,   dtwm(1),  and  returns  the  list  of
     workspaces in which this window resides.   Each  element  of
     the  list  is  the  name  of  a workspace (converted to an X
     atom).

     The display argument is the X display.

     The window argument is the window of interest.

     The *ppaWorkspaces argument is the address of a  pointer  to
     receive  the pointer to a list of workspace names (converted
     to X atoms).

     The pNumWs argument is the address of an integer to  receive
     the number of elements in the list of workspaces returned in
     *ppaWorkspaces.

RETURN VALUE
     Upon successful completion, the DtWsmGetWorkspacesOccupied()
     function  returns  Success and the workspace manager returns
     in *ppaWorkspaces a list of atoms identifying  the  occupied
     workspaces,  and  returns  in  pNumWs the number of occupied
     workspaces; otherwise, it returns a value not equal to  Suc-
     cess.

APPLICATION USAGE
     If the DtWsmGetWorkspacesOccupied() function is not success-
     ful,  failure  may  be  due  to a memory allocation error or
     failure to find the correct workspace information (that  is,
     the  CDE  workspace  manager, dtwm(1), is not running).  The
     application must use XtFree(3X) to  free  data  returned  in
     *ppaWorkspaces.

SEE ALSO
     DtWsm(5), XtFree(3X), dtwm(1).

Партнёры:

Хостинг: