[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 _gtBoxD()
 Draw a double-line box on the screen
------------------------------------------------------------------------------
 C Prototype

     #include "gt.api"
     ERRCODE _gtBoxD(
                      USHORT uiTop,
                      USHORT uiLeft,
                      USHORT uiBottom,
                      USHORT uiRight
                    )

 Arguments

     uiTop, uiLeft, uiBottom, and uiRight define the coordinates
     of the box.  Allowable row values are from zero to _gtMaxRow() and
     allowable column values are from zero to _gtMaxCol().  Specifying
     coordinates that are not within this range will result in that area
     being drawn off the screen.

 Returns

     _gtBoxD() returns zero if successful.  Any other value indicates an
     error.

 Description

     _gtBoxD() draws a double-line box at the specified coordinates on the
     screen.  Existing text and color remain unchanged.

     After _gtBoxD() executes, the cursor is located in the upper corner of
     the boxed region (uiTop + 1 and uiLeft + 1).  The internal row and
     column coordinates are updated so the CA-Clipper functions, ROW() and
     COL(), will reflect the new cursor position.

 Examples

     .  This example draws text framed by a double-line box on the
        screen:

        #include "gt.api"

        void boxTextD( USHORT uiRow, USHORT uiCol, BYTEP fpStr );

        void boxTextD( USHORT uiRow, USHORT uiCol, BYTEP fpStr )
        {
           _gtBoxD( uiRow, uiCol, uiRow + 2,
                    uiCol + strlen( fpStr ) + 2 );
           _gtWrite( fpStr, strlen( fpStr ) );
        }

 Files  Library is CLIPPER.LIB, header file is Gt.api.


See Also: _gtBox() _gtBoxS() _gtMaxCol() _gtMaxRow()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson