boss.man

来自「BOSS窗口开发 C 语言程序库」· MAN 代码 · 共 1,738 行 · 第 1/5 页

                                                           Page: 22
                                                     The Window BOSS



        4.7.7. Fields and Forms

        Fields are defined by calling the field definition functions 
        (wn_gdate, wn_gtime, wn_gphone, ...) with "SET" as the function 
        code (1st arg), a valid form handle (2nd arg), a field sequence 
        number (3rd arg), and the window handle (4th arg) belonging to 
        the window in which the form is to be displayed.  The same 
        functions that are used to retrieve discrete information can be 
        combined to create a form when used in conjunction with 
        wn_frmopn() and wn_frmget().  Note the use of XEQ vs. SET, NFRM 
        vs. f1, and NFLD in the preceding two program examples.  XEQ 
        stands for "execute now", while SET stands for "set up for later 
        execution under wn_frmget()".

        Forms are anchored to a particular window and must be created by 
        wn_frmopn() and defined with field definition functions.

        Data entry fields can be edited, pre-filled, have validation 
        ranges, and have both help and error messages associated with 
        them.  

        4.7.8. Return Values

        Some functions return an indication of success or failure which 
        you can foolishly ignore, or check to determine what action to 
        take.

        4.7.9. Closing Forms and Windows

        Both forms and windows should be closed when they are no longer 
        needed.  Although you can close them in any order, it makes sense 
        to close all forms associated with a window before closing the 
        window itself.  As a side note - attempting to reference either 
        forms or windows which have been closed can lead to unpredictable 
        results.





















                                                           Page: 23
                                                     The Window BOSS



        Important Concepts - continued.



        4.7.10. Overlapping Windows

        The Window BOSS fully supports the concept of overlapping 
        windows, that is to say that you can have several windows on the 
        screen at the same time and freely access any one of them without 
        having to be concerned with the order in which they were opened 
        or whether or not any other windows overlap the one you wish to 
        access.  The Window BOSS employs the "most recently used is 
        active" concept.  This concept is based on the following:

             . The last window referenced is the current active 
               window.  

             . The current active window is always the top window.

        For example, let us assume that you have opened three overlapping 
        windows in the following order; w1, w2, w3. w3 is considered to 
        be the top window because it was the last window referenced. If 
        you now reference, or explicitly activate w2, The Window BOSS 
        will automatically adjust the screen image to insure that w2 is 
        now the top window with w3 and w1 being partially hidden by w2.

                  Before                   After

                  +----------+             +----------+
                  |  W1      |             | W1       |
                  |  +----------+          |  +----------+
                  |  | W2       |          |  | W2       |
                  |  |  +------------+     |  |          |----+
                  |  |  | W3         |     |  |          | W3 |
                  |  |  |            |     |  |          |    |
                  |  |  +------------+     |  |          |----+
                  |  |          |          |  |          |
                  |  +----------+          |  +----------+
                  |          |             |          |
                  +----------+             +----------+

        It is extremely important to keep in mind that The Window BOSS 
        will automatically activate (bring to the top) the window being 
        referenced.  By keeping your screen layouts attractive and 
        uncluttered there will be a minimum of window thrashing which is 
        both annoying and time consuming.










                                                           Page: 24
                                                     The Window BOSS



        Important Concepts - continued.



        4.7.11. Functions

        The Window BOSS's functions fall into four major groups: those 
        that manipulate windows, those that deal with data entry, those 
        that deal with the mouse, and those that deal with the video or 
        keyboard interface at a relatively low level.  All window and 
        data manipulation functions begin with the prefix "wn_" as in 
        "wn_open".  All mouse functions begin with "mo_" as in 
        "mo_reset", while all video and keyboard based functions begin 
        with "v_" or "_" as in "v_getch" and "_putch".  This convention 
        makes it easy to remember where to look when you want to do 
        something.  Additionally, there are several global functions 
        which begin with "wns_".  These functions, although visible to 
        the outside world, are used internally by The Window BOSS. 

        So ends the tale of the basics, you are now ready to add sizzle, 
        bright lights, and artistic touches to all your applications!  



































                                                           Page: 25
                                                     The Window BOSS



        5. Distribution Methods & Media Kits 

        The Window BOSS is distributed on 5 1/4" DSDD diskettes.  There 
        are two media kits available: The Shareware diskette kit and The 
        Source diskette kit.  This doucument describes both media kits.  
        Neither media kit contains ALL of the files listed.

        The Shareware diskettes can be freely copied and shared.  The 
        Source diskettes cannot. In either case, you receive a bundled 
        product -- that is to say, we do not require you to order a 
        separate media kit for Microsoft, another for Borland, and so on.  
        All our products include support for all the compilers we 
        support. This makes moving from one compiler to another child's 
        play, and it also helps to protect your software development 
        investment, while at the same time saving you a significant sum 
        of money!

        5.1. CompuServe, GENIE, BIX, & Bulletin Board Files

        We always upload the latest release of shareware files to GENIE, 
        CompuServe, BIX, and selected BBS(s) around the country.  These 
        files can be found in the Vendor Support Software Library on the 
        IBM Round Table (M 616) of GENIE, in the "C" Language Section on 
        the IBM Programming Sig (GO IBMPRO) of CompuServe, and in the 
        "C.LANGUAGE" section of the "ibm.listings" on BIX. In all cases 
        we try to name the required files as BOSS01.LZH (code++), 
        BOSS2A.LZH & BOSS2B.LZH (libs), BOSS03.LZH (documentation).  
        Naturally, this naming convention is subject to the approval of 
        the respective service provider.  However, it is reasonable to 
        assume that the required files will always conform to a naming 
        convention that begins with "BOSS" or "BOS" and have the keyword 
        "windows" associated with them.  

        If you can not find The Window BOSS files on GENIE, BIX, or 
        CompuServe it may be due to a restructuring of the SIGs by the 
        respective service provider.  Try looking in the vendor support, 
        systems, or language areas of the SIGS.

        Bulletin Board files follow the same naming conventions as GENIE 
        and CompuServe files.  

        5.2. The SHAREWARE Distribution Diskette(s)

          The SHAREWARE diskette(s) contain the following files:

           Shareware Disk 1

             LHARC.EXE           <- Archive utility
             LHAR_DOC.LZH        <- Archive utility document archive
             BOSS_DOC.LZH        <- Window BOSS Documentation archive
             BOSS_SUP.LZH        <- Support archive (code, etc.)
             BOSS_LB2.LZH        <- Library archive (Watcom, Zortech)
             READ.ME             <- Important notes



                                                           Page: 26
                                                     The Window BOSS



        The Shareware Distribution Diskette - continued.


           Shareware Disk 2

             BOSS_LB1.LZH        <- Library archive (Microsoft)
             BOSS_LB3.LZH        <- Library archive (Mix, Aztec, C86)
             BOSS_LB4.LZH        <- Library archive (Datalight, Lattice,
                                                     Borland Turbo C)

             Contents of BOSS_DOC

               BOSS.MAN          <- This manual
               BOSS.TOC          <- Table of Contents

             Contents of BOSS_SUP

               AZCS.BAT          <- Compiler Driver - Aztec
               C86.BAT           <- Compiler Driver - CI86
               DLCS.BAT          <- Compiler Driver - Datalight
               LCS3.BAT          <- Compiler Driver - Lattice 3.4
               LCS6.BAT          <- Compiler Driver - Lattice 6.0
               MSC5.BAT          <- Compiler Driver - Microsoft C 5.X
               MSC6.BAT          <- Compiler Driver - Microsoft C 6.X
               MSQC20.BAT        <- Compiler Driver - Quick C 2.0
               MSQC25.BAT        <- Compiler Driver - Quick C 2.5
               PCCM.BAT          <- Compiler Driver - Mix Power C
               TCS.BAT           <- Compiler Driver - Turbo C
               WECS.BAT          <- Compiler Driver - EXPRESS C
               WOCS.BAT          <- Compiler Driver - Watcom C
               ZTCS.BAT          <- Compiler Driver - Zortech C
               LOADAZ.BAT        <- Link Batch file - Aztec
               LOADC86.BAT       <- Link Batch file - CI86
               LOADDLC.BAT       <- Link Batch file - Datalight
               LOADLC3.BAT       <- Link Batch file - Lattice 3.4
               LOADLC6.BAT       <- Link Batch file - Lattice 6.0
               LOADMS5.BAT       <- Link Batch file - Microsoft C 5.X
               LOADMS6.BAT       <- Link Batch file - Microsoft C 6.X
               LOADQC20.BAT      <- Link Batch file - Quick C 2.0
               LOADQC25.BAT      <- Link Batch file - Quick C 2.5
               LOADPC.BAT        <- Link Batch file - Mix Power C
               LOADTC.BAT        <- Link Batch file - Turbo C
               LOADWAT.BAT       <- Link Batch file - Watcom C
               LOADWEC.BAT       <- Link Batch file - EXPRESS C
               LOADZTC.BAT       <- Link Batch file - Zortech C
               BOSSDEMO.C        <- Source to BOSSDEMO
               BOSSDEMO.EXE      <- DEMO Program
               GENINDEX.C        <- Source to GENINDEX
               HELLO.C           <- The Classic...
               INTELC.HLP        <- Demo DATA file
               INTELC.NDX        <- Index for Demo DATA file





                                                           Page: 27
                                                     The Window BOSS



        The Shareware Distribution Diskette - continued.


             Contents of BOSS_SUP - continued.

               REV.HST           <- Revision History
               REV.LEV           <- Revision Level
               SAMPLE.C          <- Data entry sample program
               WINDOWS.FN5       <- Type Checking INCLUDE file
               WINDOWS.FN6       <- Type Checking INCLUDE file 
               WINDOWS.FNZ       <- Type Checking INCLUDE file
               WINDOWS.EXT       <- External Definition INCLUDE file
               WINDOWS.H         <- BOSS INCLUDE file
               WN_FRMGE.C        <- Data Entry form reader
               WN_GDATE.C        <- Data Entry function (dates)
               WN_GFLOA.C        <- Data Entry function (floats)
               WN_GPHON.C        <- Data Entry function (phone)
               WN_GTIME.C        <- Data Entry function (time)
               WN_GULON.C        <- Data Entry function (unsigned long)
               WN_GBOOL.C        <- Data Entry function (logical)
               WN_GDOUB.C        <- Data Entry function (double)
               WN_GINT.C         <- Data Entry function (integer)
               WN_GLONG.C        <- Data Entry function (long)
               WN_GPWOR.C        <- Data Entry function (password)
               WN_GTEXT.C        <- Data Entry function (various text)
               WN_GUINT.C        <- Data Entry function (unsigned int)
               WN_IEMSG.C        <- Data Entry error message handler
               WN_IHMSG.C        <- Data Entry help message hander
               WN_HELP.C         <- Help function source
               WN_POPUP.C        <- Popup function source
               WN_PUTS.C         <- Sourc