SECTION 2.1 - THE BASE FRAME VIEW-OBJECT ROUTINES

2.1.1 INTRODUCTION

The base frame view-object is just an empty 'top level' window on which other view-objects may be laid out. The window manager will usually add a frame of some kind round such a window and its exact appearance will therefore depend on the system on which the program is being run. Frequently the added frame will display a title which has been supplied by the application programmer. Any operations on the base frame (e.g. moving it or resizing it) are functions of the particular window manager which is running.

The following sets of routines are available:

Creating and Handling a Base Frame View-Object

2.1.2 CREATING AND HANDLING A BASE FRAME VIEW-OBJECT

2.1.2.1 Introduction

The following routines are available:

Create a base frame view-object - xdl_base_frame

2.1.2.2 Create a base frame view-object - xdl_base_frame

The routine xdl_base_frame (xdlf_base_frame) is used to create a new base frame view-object. The size of the frame is given and a title and icon label are supplied. A preferred position may be specified if required though this is just a request to the window manager which may not necesssarily be honoured. 
 
Fortran call:
 
         CALL XDLF_BASE_FRAME (IVH, IWIDTH, IHEIGHT, XDLSTR(TITLE), 
        +                      ITLEN, ICON_LABL, ILEN, IX, IY)

 
Parameters:
 
IVH        (R)  View-object handle (see vh)
IWIDTH     (R)  Frame width (see width)
IHEIGHT    (R)  Frame height (see height)
TITLE      (R)  Fortran character string containing the title
                ** Pass address using the XDLSTR function **
                (cf title)
ITITL      (R)  The title length (> 0) (cf title_len)
ICON_LABL  (R)  Fortran character string containing the icon label
                ** Pass address using the XDLSTR function **
                (cf icon_label)
ILEN       (R) The icon label length (> 0) (cf icon_len)
IX         (R) The requested 'x' position on the root window
               for the frame (-1 allow window manager to choose)
               (see x)
IY         (R) The requested 'y' position c.f. IX
IY         (R) The requested 'y' position c.f. IX

 
'C' call:
 
void xdl_base_frame (vh, width, height, title, title_len, 
                     icon_label, icon_len, x, y)

 
Parameters:
 
int vh;             /* User selected view-object handle (R)*/
int width;          /* Frame width (including border width of 1 at each 
                       side but excluding any window manager additions) 
                       (R)*/
int height;         /* Frame height (including border width of 1 at top
                       and bottom but excluding any window manager 
                       additions) (R)*/
char * title;       /* Title string (R)*/
int title_len;      /* The length of the title string; if the string is
                       null terminated then 0 may be given and the program
                       will determine the string length (R)*/
char * icon_label;  /* Icon label string (R)*/
int icon_len;       /* The length of the icon label string; if the string 
                       is null terminated then 0 may be given and the 
                       program will determine the string length (R)*/
int x;              /* Requested root window 'x' position. This acts
                       as a hint to the window manager (if x=-1 and
                       y=-1 then the choice of position is left to
                       the window manager (R)*/
int y;              /* Requested root window 'y' position. c.f. 'x' (R)*/


Return:  None


John W. Campbell
CCLRC Daresbury Laboratory
Last update 4 Feb 1998