SECTION 2.13 - THE BLANK OBJECT VIEW-OBJECT ROUTINES

2.13.1 INTRODUCTION

The blank object view-object is merely a window with a surrounding border similar to that used in other view-objects which may be output on a display for aesthetic reasons to indicate the position on a tiled display which will be occupied by another view-object later.

The following sets of routines are available:

Creating and Handling a Blank View-Object

2.13.2 CREATING AND HANDLING A BLANK VIEW-OBJECT

2.13.2.1 Introduction

The following routines are available:

Create a blank object view-object - xdl_blank_object

2.13.2.2 Create a blank object view-object - xdl_blank_object

THe routine xdl_blank_object (xdlf_blank_object) is used to create a new blank object view-object. The size of the object is supplied by the user.

 
Fortran call:
 
         CALL XDLF_blank_OBJECT (IVH, IVHPARENT, IX, IY, ICSET, IWIDTH, 
        +                        IHEIGHT, IERR)

 
Parameters:
 
IVH       (R)   View-object handle (see vh)
IVHPARENT (R)   View-object handle for parent 0=none 
                (see vh_parent)
IX        (R)   X position (may be -1 if no parent) (see x)
IY        (R)   Y position (may be -1 if no parent) (see y)
ICSET     (R)   Colorset number (see cset)
IWIDTH    (R)   Width in pixels (see width)
IHEIGHT   (R)   Height in pixels (see height)
IERR      (W)   Returns status from xdl_blank_object call

 
'C' call:
 
int xdl_blank_object (vh, vh_parent, x, y, cset, width, height)

 
Parameters:
 
int       vh;             /* User selected view-object handle (R)*/
int       vh_parent;      /* View-object handle for the parent base frame,
                             if 0 then a base  level frame is created to
                             enclose the blank view-object (R)*/
int       x;              /* x coordinate for the view-object.
                             If no parent may be -1 to give default x (R)*/
int       y;              /* y coordinate for the view-object.
                             If no parent may be -1 to give default y (R)*/
int       cset;           /* Number of the colorset to be used - 
                             normally 0 (R)*/
int       width;          /* Window width in pixels (R)*/
int       height;         /* Window height in pixels (R)*/

Return:  Status flag =0 OK, >0 error
                bit 0 set: Requested parent not found in view-objects list

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