369308b737
Ok - so one of the steps in building CDE is an early phase called the includes phase (make includes). At this point, all of the public header files are exported to exports/include/Dt, DtI, ... Then, the software is built using that include dir. This of course does not work in autotools. Much of the software does things like #include <Dt/something.h>, so in order for the build to succeed, this behavior must be represented/replicated in some way. It seems the usual way of dealing with this is to place all public headers (and in some projects, ALL headers) into a toplevel include directory. We now do this for all public headers - they have been moved from wherever they were and placed in the appropriate spot in includes/ This will break the Imake 'make includes' phase unless the Imakefiles are fixed (remove the HEADERS = stuff, and the incdir defines). This has not been done at this point since in reality, once autotools works properly, there will be no need for the Imake stuff anymore, and I intend to get rid of it. This is just a warning for now - Imake builds in this tree will now fail at the 'includes' stage. This commit is only the migration. In upcoming commits, libtt will be fixed so that the hack being used before to get around this problem is removed as there will no longer be any need. And then the autotools work continues...
849 lines
25 KiB
C
849 lines
25 KiB
C
/*
|
|
* CDE - Common Desktop Environment
|
|
*
|
|
* Copyright (c) 1993-2012, The Open Group. All rights reserved.
|
|
*
|
|
* These libraries and programs are free software; you can
|
|
* redistribute them and/or modify them under the terms of the GNU
|
|
* Lesser General Public License as published by the Free Software
|
|
* Foundation; either version 2 of the License, or (at your option)
|
|
* any later version.
|
|
*
|
|
* These libraries and programs are distributed in the hope that
|
|
* they will be useful, but WITHOUT ANY WARRANTY; without even the
|
|
* implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
|
|
* PURPOSE. See the GNU Lesser General Public License for more
|
|
* details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with these libraries and programs; if not, write
|
|
* to the Free Software Foundation, Inc., 51 Franklin Street, Fifth
|
|
* Floor, Boston, MA 02110-1301 USA
|
|
*/
|
|
/* $XConsortium: WsmP.h /main/8 1996/05/20 16:08:59 drk $ */
|
|
|
|
/************************************<+>*************************************
|
|
****************************************************************************
|
|
**
|
|
** File: WsmP.h
|
|
**
|
|
** Project: DT Workspace Manager
|
|
**
|
|
** Description: Defines PRIVATE properties, structures, and
|
|
** parameters used for communication with the
|
|
** workspace manager.
|
|
**
|
|
** (c) Copyright 1996 Digital Equipment Corporation.
|
|
** (c) Copyright 1993,1994,1996 Hewlett-Packard Company.
|
|
** (c) Copyright 1993,1994,1996 International Business Machines Corp.
|
|
** (c) Copyright 1993,1994,1996 Sun Microsystems, Inc.
|
|
** (c) Copyright 1993,1994,1996 Novell, Inc.
|
|
** (c) Copyright 1996 FUJITSU LIMITED.
|
|
** (c) Copyright 1996 Hitachi.
|
|
**
|
|
****************************************************************************
|
|
************************************<+>*************************************/
|
|
#ifndef _Dt_WsmP_h
|
|
#define _Dt_WsmP_h
|
|
#include <Dt/Wsm.h>
|
|
#include <X11/Intrinsic.h>
|
|
#include <Dt/Service.h>
|
|
#include <Tt/tt_c.h>
|
|
|
|
/**********************************************************************
|
|
* Workspace atom names
|
|
**********************************************************************/
|
|
#define _XA_DT_MARQUEE_SELECTION "_DT_MARQUEE_SELECTION"
|
|
#define _XA_DT_WORKSPACE_EMBEDDED_CLIENTS \
|
|
"_DT_WORKSPACE_EMBEDDED_CLIENTS"
|
|
#define _XA_DT_WM_REQUEST "_DT_WM_REQUEST"
|
|
#define _XA_DT_WORKSPACE_HINTS "_DT_WORKSPACE_HINTS"
|
|
#define _XA_DT_WORKSPACE_PRESENCE "_DT_WORKSPACE_PRESENCE"
|
|
#define _XA_DT_WORKSPACE_INFO "_DT_WORKSPACE_INFO"
|
|
#define _XA_DT_WM_HINTS "_DT_WM_HINTS"
|
|
#define _XA_DT_WORKSPACE_LIST "_DT_WORKSPACE_LIST"
|
|
#define _XA_DT_WORKSPACE_CURRENT "_DT_WORKSPACE_CURRENT"
|
|
|
|
|
|
/**********************************************************************
|
|
* Name to request ``all'' workspaces (for a persistent window)
|
|
**********************************************************************/
|
|
|
|
#define _XA_DT_WORKSPACE_ALL "all"
|
|
|
|
|
|
/**********************************************************************
|
|
* Workspace function definitions
|
|
**********************************************************************/
|
|
#define DtWM_FUNC_OCCUPY_WS DtWM_FUNCTION_OCCUPY_WS
|
|
#define DtWM_FUNC_ALL DtWM_FUNC_OCCUPY_WS
|
|
|
|
/**********************************************************************
|
|
* Workspace property information
|
|
**********************************************************************/
|
|
|
|
/*
|
|
*
|
|
* NOTE: The "(client -> dtwm)" indication calls out the direction
|
|
* of information flow. In this case, the client writes the
|
|
* property and dtwm reads the property.
|
|
*
|
|
*
|
|
* _DT_WORKSPACE_HINTS (client -> dtwm)
|
|
*
|
|
* This property is a list of atoms placed by a client on its
|
|
* top level window(s). Each atom is an "interned" string name
|
|
* for a workspace. The workspace manager looks at this property
|
|
* when it manages the window (e.g. when the window is mapped)
|
|
* and will place the window in the workspaces listed.
|
|
*
|
|
* _DT_WORKSPACE_PRESENCE (dtwm -> client)
|
|
*
|
|
* This property is a list of atoms placed on a client by dtwm.
|
|
* Each atom is an "interned" string name for a workspace. This
|
|
* property lists the workspaces that this client lives in.
|
|
*
|
|
* _DT_WORKSPACE_LIST (dtwm -> clients)
|
|
*
|
|
* This property is a list of atoms. Each atom represents a
|
|
* name of a workspace. The list is in "order" such that
|
|
* the first element is for the first workspace and so on.
|
|
* This proeprty is placed on the mwm ("wmWindow") window.
|
|
*
|
|
* _DT_WORKSPACE_CURRENT (dtwm -> clients)
|
|
*
|
|
* This property is a single atom, representing the current
|
|
* workspace. It is updated each time the workspace changes.
|
|
* This proeprty is placed on the mwm window.
|
|
*
|
|
* _DT_WORKSPACE_INFO_<name> (dtwm -> clients)
|
|
*
|
|
* There is one property of this form for each workspace in
|
|
* _DT_WORKSPACE_LIST. This property is a sequence of ISO-LATIN1
|
|
* NULL-terminated strings representing the elements in a
|
|
* structure. This information was formerly in _DT_WORKSPACE_INFO
|
|
* but was broken out to allow for extensibility.
|
|
* This proeprty is placed on the mwm window.
|
|
*
|
|
* _DT_WM_HINTS (client -> dtwm)
|
|
*
|
|
* This property requests specific window/workspace management behavior.
|
|
* The functions member of the property allows a client to enable or
|
|
* disable workspace management functions. The behavior member is
|
|
* used to indicate front panels and slide-ups.
|
|
*
|
|
*/
|
|
|
|
|
|
/**********************************************************************
|
|
* Property structures
|
|
**********************************************************************/
|
|
|
|
typedef struct _DtWmHints
|
|
{
|
|
long flags; /* marks valid fields */
|
|
long functions; /* special dtwm functions */
|
|
long behaviors; /* special dtwm behaviors */
|
|
Window attachWindow; /* (reserved) */
|
|
} DtWmHints;
|
|
|
|
/* DtWmHints "flags" definitions */
|
|
#define DtWM_HINTS_FUNCTIONS (1L << 0)
|
|
#define DtWM_HINTS_BEHAVIORS (1L << 1)
|
|
#define DtWM_HINTS_ATTACH_WINDOW (1L << 2) /* (reserved) */
|
|
|
|
/* DtWmHints "functions" definitions */
|
|
#define DtWM_FUNCTION_ALL (1L << 0)
|
|
#define DtWM_FUNCTION_OCCUPY_WS (1L << 16)
|
|
|
|
/* DtWmHints "behaviors" definitions */
|
|
#define DtWM_BEHAVIOR_PANEL (1L << 1)
|
|
#define DtWM_BEHAVIOR_SUBPANEL (1L << 2)
|
|
#define DtWM_BEHAVIOR_SUB_RESTORED (1L << 3)
|
|
|
|
/**********************************************************************
|
|
* Session atom names
|
|
**********************************************************************/
|
|
#define _XA_DT_SESSION_HINTS "_DT_SESSION_HINTS"
|
|
#define _XA_DT_SAVE_MODE "_DT_SAVE_MODE"
|
|
#define _XA_DT_RESTORE_MODE "_DT_RESTORE_MODE"
|
|
#define _XA_DT_RESTORE_DIR "_DT_RESTORE_DIR"
|
|
#define _XA_DT_SM_WM_PROTOCOL "_DT_SM_WM_PROTOCOL"
|
|
#define _XA_DT_SM_START_ACK_WINDOWS "_DT_SM_START_ACK_WINDOWS"
|
|
#define _XA_DT_SM_STOP_ACK_WINDOWS "_DT_SM_STOP_ACK_WINDOWS"
|
|
#define _XA_DT_WM_WINDOW_ACK "_DT_WM_WINDOW_ACK"
|
|
#define _XA_DT_WM_EXIT_SESSION "_DT_WM_EXIT_SESSION"
|
|
#define _XA_DT_WM_LOCK_DISPLAY "_DT_WM_LOCK_DISPLAY"
|
|
#define _XA_DT_WM_READY "_DT_WM_READY"
|
|
|
|
/**********************************************************************
|
|
* Workspace special character definitions
|
|
**********************************************************************/
|
|
#define DTWM_CH_ESC_NEXT "\\"
|
|
|
|
/**********************************************************************
|
|
* Marquee selection callback prototype
|
|
**********************************************************************/
|
|
typedef void (*DtWsmMarqueeSelectionProc) ();
|
|
/*
|
|
Widget widget;
|
|
int type;
|
|
Position x, y;
|
|
Dimension width, height;
|
|
XtPointer client_data;
|
|
*/
|
|
|
|
/**********************************************************************
|
|
* Marquee Select
|
|
**********************************************************************/
|
|
|
|
#define DT_WSM_MARQUEE_SELECTION_TYPE_BEGIN 1
|
|
#define DT_WSM_MARQUEE_SELECTION_TYPE_CONTINUE 2
|
|
#define DT_WSM_MARQUEE_SELECTION_TYPE_END 3
|
|
#define DT_WSM_MARQUEE_SELECTION_TYPE_CANCEL 4
|
|
|
|
/**********************************************************************
|
|
* Workspace request definitions
|
|
*
|
|
* NOTE: These functions do not necessarily match the other
|
|
* window manager f.* functions!
|
|
**********************************************************************/
|
|
#define DTWM_REQ_CHANGE_BACKDROP "f.change_backdrop"
|
|
#define DTWM_REQ_RESTART "f.restart"
|
|
|
|
/**********************************************************************
|
|
* Workspace request parameter definitions
|
|
**********************************************************************/
|
|
#define DTWM_REQP_BACKDROP_NONE "NoBackdrop"
|
|
#define DTWM_REQP_NO_CONFIRM "-noconfirm"
|
|
|
|
/**********************************************************************
|
|
* Resource converter definitions
|
|
*
|
|
* NOTE: This has been lifted from mwm.
|
|
* Please keep syncronized with the current version of mwm/dtwm.
|
|
* (See WmGlobal.h)
|
|
**********************************************************************/
|
|
|
|
/* icon placement values (iconPlacement, ...): */
|
|
#define ICON_PLACE_LEFT_PRIMARY (1L << 0)
|
|
#define ICON_PLACE_RIGHT_PRIMARY (1L << 1)
|
|
#define ICON_PLACE_TOP_PRIMARY (1L << 2)
|
|
#define ICON_PLACE_BOTTOM_PRIMARY (1L << 3)
|
|
#define ICON_PLACE_LEFT_SECONDARY (1L << 4)
|
|
#define ICON_PLACE_RIGHT_SECONDARY (1L << 5)
|
|
#define ICON_PLACE_TOP_SECONDARY (1L << 6)
|
|
#define ICON_PLACE_BOTTOM_SECONDARY (1L << 7)
|
|
#define ICON_PLACE_EDGE (1L << 8)
|
|
#define ICON_PLACE_TIGHT (1L << 9)
|
|
#define ICON_PLACE_RESERVE (1L << 10)
|
|
|
|
/**********************************************************************
|
|
* Workspace property information
|
|
**********************************************************************/
|
|
|
|
/*
|
|
*
|
|
* NOTE: The "(client -> dtwm)" indication calls out the direction
|
|
* of information flow. In this case, the client writes the
|
|
* property and dtwm reads the property.
|
|
*
|
|
* _DT_WM_REQUEST (client -> dtwm)
|
|
*
|
|
* This property of type string that is used to communication
|
|
* function requests to dtwm. This property is placed on the mwm
|
|
* window. Dtwm listens for changes to this property and dequeues
|
|
* requests off the top of the list. Requests are NULL-terminated
|
|
* strings in the format:
|
|
*
|
|
* <req_type> <req_parms>
|
|
*
|
|
* Each request ends with a literal '\0' character to insure
|
|
* separation from the next request.
|
|
*
|
|
* Clients must always add requests to the end of the property
|
|
* (mode=PropModeAppend). Use of convenience routines is
|
|
* recommended since they take care of proper formatting of the
|
|
* requests.
|
|
*
|
|
*/
|
|
|
|
|
|
/**********************************************************************
|
|
* Property structures
|
|
**********************************************************************/
|
|
|
|
/* Internal form of this property */
|
|
typedef struct _DtWorkspaceHints
|
|
{
|
|
long version; /* indicates structure changes */
|
|
long flags; /* marks valid fields */
|
|
long wsflags; /* special workspace information */
|
|
long numWorkspaces; /* number of workspaces */
|
|
Atom * pWorkspaces; /* list of atoms for workspaces */
|
|
} DtWorkspaceHints;
|
|
|
|
/* DtWorkspaceHints "flags" definitions */
|
|
#define DT_WORKSPACE_HINTS_WSFLAGS (1L << 0)
|
|
/* The following definitions enables both the numWorkspaces
|
|
and pWorkspaces fields */
|
|
#define DT_WORKSPACE_HINTS_WORKSPACES (1L << 1)
|
|
|
|
/* DtWorkspaceHints "wsflags" definitions */
|
|
#define DT_WORKSPACE_FLAGS_OCCUPY_ALL (1L << 0)
|
|
|
|
/**********************************************************************
|
|
* Marquee Selection Structures
|
|
**********************************************************************/
|
|
typedef struct _DtMarqueeSelectData
|
|
{
|
|
long state; /* current property state */
|
|
Position x; /* NW corner of select area */
|
|
Position y; /* NW corner of select area */
|
|
Dimension width; /* size of select area */
|
|
Dimension height; /* size of select area */
|
|
} DtMarqueeSelectData;
|
|
|
|
typedef struct _DtMarqueeSelectProp
|
|
{
|
|
long state; /* current property state */
|
|
long x; /* NW corner of select area */
|
|
long y; /* NW corner of select area */
|
|
long width; /* size of select area */
|
|
long height; /* size of select area */
|
|
} DtMarqueeSelectProperty;
|
|
|
|
/**********************************************************************
|
|
* Marquee Selection Definitions
|
|
**********************************************************************/
|
|
#define DT_MARQUEE_SELECT_BEGIN 1
|
|
#define DT_MARQUEE_SELECT_CONTINUE 2
|
|
#define DT_MARQUEE_SELECT_END 3
|
|
#define DT_MARQUEE_SELECT_CANCEL 4
|
|
|
|
/**********************************************************************
|
|
* Workspace change callback context (opaque)
|
|
**********************************************************************/
|
|
typedef void (*DtWsmCBProc) ();
|
|
struct _DtWsmCBContext
|
|
{
|
|
Tt_pattern pattern;
|
|
Widget widget;
|
|
DtWsmCBProc ws_cb;
|
|
XtPointer client_data;
|
|
XtPointer nested_context;
|
|
};
|
|
|
|
/**********************************************************************
|
|
* Convenience Routines
|
|
**********************************************************************/
|
|
|
|
/*************************************<->*************************************
|
|
*
|
|
* int _DtGetMwmWindow (display, root, pMwmWindow)
|
|
*
|
|
*
|
|
* Description:
|
|
* -----------
|
|
* Get the Motif Window manager window
|
|
*
|
|
*
|
|
* Inputs:
|
|
* ------
|
|
* display - display
|
|
* root - root window of screen
|
|
* pMwmWindow - pointer to a window (to be returned)
|
|
*
|
|
* Outputs:
|
|
* --------
|
|
* *pMwmWindow - mwm window id, if successful
|
|
* Return - status from XGetWindowProperty
|
|
*
|
|
* Comments:
|
|
* --------
|
|
* This can fail if mwm is not managing the screen for the root window
|
|
* passed in.
|
|
*
|
|
*************************************<->***********************************/
|
|
extern int
|
|
_DtGetMwmWindow(
|
|
Display *display,
|
|
Window root,
|
|
Window *pMwmWindow) ;
|
|
|
|
|
|
/*************************************<->*************************************
|
|
*
|
|
* int _DtGetEmbeddedClients (display, root, ppEmbeddedClients,
|
|
* pNumEmbeddedClients)
|
|
*
|
|
*
|
|
* Description:
|
|
* -----------
|
|
* Get the contents of the _DT_WORKSPACE_EMBEDDED_CLIENTS property
|
|
* from a root window. This is a list (array) of top-level windows that
|
|
* are embedded in the front panel of the window manager. They would
|
|
* not be picked up ordinarily by a session manager in a normal
|
|
* search for top-level windows because they are reparented to
|
|
* the front panel which itself is a top-level window.
|
|
*
|
|
*
|
|
* Inputs:
|
|
* ------
|
|
* display - display
|
|
* root - root window to get info from
|
|
* ppEmbeddedClients - pointer to a pointer (to be returned)
|
|
* pNumEmbeddedClients - pointer to a number (to be returned)
|
|
*
|
|
* Outputs:
|
|
* -------
|
|
* *ppEmbeddedClients - pointer to a array of window IDs (top-level
|
|
* windows for embedded clients)
|
|
* (NOTE: This should be freed using XFree)
|
|
* *pNumEmbeddedClients- number of window IDs in array
|
|
* Return - Success if property fetched ok.
|
|
* Failure returns are from XGetWindowProperty
|
|
*
|
|
* Comments:
|
|
* --------
|
|
* Use XFree to free the returned data.
|
|
*
|
|
*************************************<->***********************************/
|
|
extern int
|
|
_DtGetEmbeddedClients(
|
|
Display *display,
|
|
Window root,
|
|
Atom **ppEmbeddedClients,
|
|
unsigned long *pNumEmbeddedClients );
|
|
|
|
|
|
/*************************************<->*************************************
|
|
*
|
|
* int _DtWmRestart (display, root)
|
|
*
|
|
*
|
|
* Description:
|
|
* -----------
|
|
* Requests the window manager to restart itself
|
|
*
|
|
*
|
|
* Inputs:
|
|
* ------
|
|
* display - display
|
|
* root - root window for screen
|
|
*
|
|
* Returns:
|
|
* --------
|
|
* Success if request was sent
|
|
*
|
|
* Comments:
|
|
* ---------
|
|
*
|
|
*************************************<->***********************************/
|
|
extern int
|
|
_DtWmRestart(
|
|
Display *display,
|
|
Window root) ;
|
|
|
|
/*************************************<->*************************************
|
|
*
|
|
* int _DtWsmChangeBackdrop (display, root, path, pixmap)
|
|
*
|
|
*
|
|
* Description:
|
|
* -----------
|
|
* Request the HP DT workspace manager to change the backdrop
|
|
*
|
|
*
|
|
* Inputs:
|
|
* ------
|
|
* display - display
|
|
* root - root window of screen
|
|
* path - file path to bitmap file
|
|
* pixmap - pixmap id of backdrop pixmap
|
|
*
|
|
* Returns:
|
|
* --------
|
|
* Success if request sent
|
|
*
|
|
*************************************<->***********************************/
|
|
extern int
|
|
_DtWsmChangeBackdrop (
|
|
Display *display,
|
|
Window root,
|
|
char *path,
|
|
Pixmap pixmap);
|
|
|
|
/*************************************<->*************************************
|
|
*
|
|
* _DtWmCvtStringToIPlace (args, numArgs, fromVal, toVal)
|
|
*
|
|
*
|
|
* Description:
|
|
* -----------
|
|
* This function converts a string to an icon placement scheme description.
|
|
*
|
|
*
|
|
* Inputs:
|
|
* ------
|
|
* args = NULL (don't care)
|
|
*
|
|
* numArgs = 0 (don't care)
|
|
*
|
|
* fromVal = resource value to convert
|
|
*
|
|
*
|
|
* Outputs:
|
|
* -------
|
|
* toVal = descriptor to use to return converted value
|
|
*
|
|
*************************************<->***********************************/
|
|
|
|
extern void
|
|
_DtWmCvtStringToIPlace (
|
|
XrmValue *args,
|
|
Cardinal numArgs,
|
|
XrmValue *fromVal,
|
|
XrmValue *toVal);
|
|
|
|
|
|
/*************************************<->*************************************
|
|
*
|
|
* Boolean _DtWsmIsBackdropWindow (display, screen_num, window)
|
|
*
|
|
*
|
|
* Description:
|
|
* -----------
|
|
* Returns true if the window passed in is a backdrop window.
|
|
*
|
|
*
|
|
* Inputs:
|
|
* ------
|
|
* display - display
|
|
* screen_num - number of screen we're interested in
|
|
* window - window we want to test
|
|
*
|
|
* Outputs:
|
|
* -------
|
|
* Return - True if window is a backdrop window
|
|
* False otherwise.
|
|
*
|
|
* Comments:
|
|
* --------
|
|
*
|
|
*************************************<->***********************************/
|
|
Boolean
|
|
_DtWsmIsBackdropWindow(
|
|
Display *display,
|
|
int screen_num,
|
|
Window window );
|
|
|
|
/*************************************<->*************************************
|
|
*
|
|
* int DtWsmSetWorkspaceTitle (widget, aWs, pchNewName)
|
|
*
|
|
*
|
|
* Description:
|
|
* -----------
|
|
* Rename a workspace
|
|
*
|
|
*
|
|
* Inputs:
|
|
* ------
|
|
* widget - a widget
|
|
* aWs - atom of workspace
|
|
* pchNewName - new name for the workspace
|
|
*
|
|
* Outputs:
|
|
* --------
|
|
* Return - 1 (*not* Success) if communication to workspace manager
|
|
* was successful.
|
|
*
|
|
* Comments:
|
|
* ---------
|
|
* The odd-ball successful return value is a CDE 1.0 bug being
|
|
* preserved for backward compatibility.
|
|
*
|
|
*************************************<->***********************************/
|
|
int
|
|
_DtWsmSetWorkspaceTitle (
|
|
Widget widget,
|
|
Atom aWs,
|
|
char * pchNewName);
|
|
|
|
/*************************************<->*************************************
|
|
*
|
|
* int _DtWsmDeleteWorkspace (widget, aWs)
|
|
*
|
|
*
|
|
* Description:
|
|
* -----------
|
|
* Delete a workspace
|
|
*
|
|
*
|
|
* Inputs:
|
|
* ------
|
|
* widget - a widget (with a window!)
|
|
* aWs - atom of workspace to delete
|
|
*
|
|
* Outputs:
|
|
* --------
|
|
* Return - 1 (*not* Success) if communication to workspace manager
|
|
* was successful.
|
|
*
|
|
* Comments:
|
|
* ---------
|
|
* The odd-ball successful return value is a CDE 1.0 bug being
|
|
* preserved for backward compatibility.
|
|
*
|
|
*************************************<->***********************************/
|
|
int
|
|
_DtWsmDeleteWorkspace (
|
|
Widget widget,
|
|
Atom aWs);
|
|
|
|
|
|
/*************************************<->*************************************
|
|
*
|
|
* int _DtWsmCreateWorkspace (widget, pchTitle)
|
|
*
|
|
*
|
|
* Description:
|
|
* -----------
|
|
* Add a workspace
|
|
*
|
|
*
|
|
* Inputs:
|
|
* ------
|
|
* widget - a widget (with a window!)
|
|
* pchTitle - user-visible title of the workspace
|
|
*
|
|
* Outputs:
|
|
* --------
|
|
* Return - 1 (*not* Success) if communication to workspace manager
|
|
* was successful.
|
|
*
|
|
* Comments:
|
|
* ---------
|
|
* The odd-ball successful return value is a CDE 1.0 bug being
|
|
* preserved for backward compatibility.
|
|
*
|
|
*************************************<->***********************************/
|
|
int
|
|
_DtWsmCreateWorkspace (Widget widget, char * pchTitle);
|
|
|
|
/*************************************<->*************************************
|
|
*
|
|
* _DtWsmSetWorkspaceHints (display, window, pWsHints)
|
|
*
|
|
*
|
|
* Description:
|
|
* -----------
|
|
* Set the contents of the _DT_WORKSPACE_HINTS property on a window
|
|
*
|
|
*
|
|
* Inputs:
|
|
* ------
|
|
* display - display
|
|
* window - window to get hints from
|
|
* pWsHints - pointer to workspace hints
|
|
*
|
|
* Comments:
|
|
* ---------
|
|
* The internal form of the property is a structure. The structure
|
|
* must be unwound and turned into a simple array of "long"s before
|
|
* being written out.
|
|
*
|
|
* This function currently only deals with version 1 of the property
|
|
* structure. The passed in pWsHints->version is ignored.
|
|
*
|
|
*************************************<->***********************************/
|
|
extern void
|
|
_DtWsmSetWorkspaceHints(
|
|
Display *display,
|
|
Window window,
|
|
DtWorkspaceHints *pWsHints);
|
|
|
|
|
|
/*************************************<->*************************************
|
|
*
|
|
* int _DtWsmGetWorkspaceHints (display, window, ppWsHints)
|
|
*
|
|
*
|
|
* Description:
|
|
* -----------
|
|
* Get the contents of the _DT_WORKSPACE_HINTS property from a window
|
|
*
|
|
*
|
|
* Inputs:
|
|
* ------
|
|
* display - display
|
|
* window - window to get hints from
|
|
* ppWsHints - pointer to pointer to workspace hints
|
|
*
|
|
* Outputs:
|
|
* *ppWsHints - allocated workspace hints data.
|
|
*
|
|
* Comments:
|
|
* ---------
|
|
* The internal form of the property is a structure. The property
|
|
* is read in and packed into data allocated for the structure.
|
|
* Free the workspace hints by calling _DtWsmFreeWorkspaceHints.
|
|
*
|
|
* This function currently only deals with version 1 of the property
|
|
* structure.
|
|
*
|
|
*************************************<->***********************************/
|
|
extern int
|
|
_DtWsmGetWorkspaceHints(
|
|
Display *display,
|
|
Window window,
|
|
DtWorkspaceHints **ppWsHints);
|
|
|
|
/*************************************<->*************************************
|
|
*
|
|
* _DtWsmFreeWorkspaceHints (pWsHints)
|
|
*
|
|
*
|
|
* Description:
|
|
* -----------
|
|
* Free a workspace hints structure returned from _DtWsmGetWorkspaceHints
|
|
*
|
|
* Inputs:
|
|
* ------
|
|
* pWsHints - pointer to workspace hints
|
|
*
|
|
* Outputs:
|
|
*
|
|
* Comments:
|
|
* ---------
|
|
*************************************<->***********************************/
|
|
extern void
|
|
_DtWsmFreeWorkspaceHints(
|
|
DtWorkspaceHints *pWsHints);
|
|
|
|
/*************************************<->*************************************
|
|
*
|
|
* DtWsmCBContext * _DtWsmAddMarqueeSelectionCallback (widget,
|
|
* marquee_select,
|
|
* client_data)
|
|
*
|
|
*
|
|
* Description:
|
|
* -----------
|
|
* Register a function to be called when a marquee selection is made
|
|
*
|
|
*
|
|
* Inputs:
|
|
* ------
|
|
* widget - widget for this client
|
|
* marquee_select - function to call for marquee select
|
|
* client_data - additional data to pass back to client when called.
|
|
*
|
|
* Outputs:
|
|
* --------
|
|
* Return - ptr to callback context data (opaque)
|
|
*
|
|
* Comments:
|
|
* ---------
|
|
* The callback context data ptr should be saved if you intend to
|
|
* removed this callback at some point in the future.
|
|
*
|
|
*************************************<->***********************************/
|
|
DtWsmCBContext
|
|
_DtWsmAddMarqueeSelectionCallback (
|
|
Widget widget,
|
|
DtWsmMarqueeSelectionProc marquee_select,
|
|
XtPointer client_data);
|
|
|
|
/*************************************<->*************************************
|
|
*
|
|
* _DtWsmSetDtWmHints (display, window, pHints)
|
|
*
|
|
*
|
|
* Description:
|
|
* -----------
|
|
* Set the contents of the _DT_WM_HINTS property on a window
|
|
*
|
|
*
|
|
* Inputs:
|
|
* ------
|
|
* display - display
|
|
* window - window to set hints on
|
|
* pHints - pointer the hints to set
|
|
*
|
|
* Comments:
|
|
* ---------
|
|
* No error checking
|
|
*
|
|
*************************************<->***********************************/
|
|
extern void
|
|
_DtWsmSetDtWmHints( Display *display,
|
|
Window window,
|
|
DtWmHints *pHints);
|
|
|
|
/*************************************<->*************************************
|
|
*
|
|
* int _DtWsmGetDtWmHints (display, window, ppDtWmHints)
|
|
*
|
|
*
|
|
* Description:
|
|
* -----------
|
|
* Get the contents of the _DT_WM_HINTS property on a window
|
|
*
|
|
*
|
|
* Inputs:
|
|
* ------
|
|
* display - display
|
|
* window - window to get hints from
|
|
* ppDtWmHints - pointer to a pointer to return
|
|
*
|
|
* Outputs:
|
|
* --------
|
|
* *ppDtWmHints-points to the DtWmHints structure retrieved from
|
|
* the window (NOTE: This should be freed using XFree)
|
|
*
|
|
* Comments:
|
|
* ---------
|
|
*
|
|
*************************************<->***********************************/
|
|
extern int
|
|
_DtWsmGetDtWmHints(
|
|
Display *display,
|
|
Window window,
|
|
DtWmHints **ppDtWmHints);
|
|
|
|
/*************************************<->*************************************
|
|
*
|
|
* _DtWsmSelectionNameForScreen (scr)
|
|
*
|
|
* Description:
|
|
* -----------
|
|
* Returns a string containing the selection name used for
|
|
* communication with the workspace manager on this screen
|
|
*
|
|
*
|
|
* Inputs:
|
|
* ------
|
|
* scr - number of screen
|
|
*
|
|
* Outputs:
|
|
* --------
|
|
* Return - ptr to string with selection name (free with XtFree)
|
|
*
|
|
* Comments:
|
|
* ---------
|
|
* Assumes the screen number is < 1000.
|
|
*
|
|
*************************************<->***********************************/
|
|
extern String
|
|
_DtWsmSelectionNameForScreen (int scr);
|
|
|
|
extern Tt_callback_action
|
|
_DtWsmConsumeReply (
|
|
Tt_message msg,
|
|
Tt_pattern pat );
|
|
|
|
#endif /* _Dt_WsmP_h */
|
|
/* Do not add anything after this endif. */
|