home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / VISBUILD / CALCULAT / AVLTCAL2.SPC next >
Text File  |  1995-05-15  |  9KB  |  405 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                                                           SPECIFICATION FOR THE
  14.                                                          CALCULATOR APPLICATION
  15.                                                                     VERSION 2.1
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                                                                    May 15, 1995
  24.  
  25.  
  26.                                                             Alpha Omega Company
  27.  
  28.  
  29.                                                            Cary, North Carolina
  30.                                                                    avltcal2.spc
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.   CONTENTS
  73.   ________
  74.  
  75.  
  76.  
  77.  
  78.  
  79.                       Document Description   . . . . . . . . . . . . . . . .  1
  80.                       Document Control   . . . . . . . . . . . . . . . . . .  1
  81.  
  82.                       CREATING A SIMPLE CALCULATOR APPLICATION (V2)  . . . .  3
  83.                       What You Should Be Able To Do  . . . . . . . . . . . .  3
  84.                       Specification  . . . . . . . . . . . . . . . . . . . .  5
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                     Contents  2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.   DOCUMENT DESCRIPTION
  140.   ____________________
  141.  
  142.   
  143.    CREATING A SIMPLE CALCULATOR APPLICATION (V2)
  144.   _____________________________________________
  145.  
  146.  
  147.  
  148.  
  149.  
  150.                       This scenario shows you how to build an application that
  151.                       uses the following:
  152.  
  153.                       o   Text Entry Field
  154.  
  155.                       o   Multiline Edit Field
  156.  
  157.                       o   Push buttons
  158.  
  159.                       o   File dialog box
  160.  
  161.                       o   An imbedded view
  162.  
  163.                       o   Parameterized connections
  164.  
  165.                       o   User provided non-visual parts
  166.  
  167.                       o   Message Box
  168.  
  169.                       o   Simple exception handling (divide by zero)
  170.  
  171.                       o   Command handler
  172.  
  173.                       o   Keyboard handler
  174.  
  175.  
  176.   WHAT YOU SHOULD BE ABLE TO DO
  177.   _____________________________
  178.  
  179.                       o   Start Visual Builder.
  180.  
  181.                       o   Upgrade the V1 calculator application.
  182.  
  183.                       o   Import user provided non-visual parts.
  184.  
  185.                       o   Use the Public Interface Editor.
  186.  
  187.                       o   Use the Composition Editor to update the views of V1
  188.                           Calculator.
  189.  
  190.                           -   Add/remove non-visual parts on the layout
  191.                               surface.
  192.                           -   Add/remove user provided parts on the layout
  193.                               surface.
  194.                           -   Make/change connections between parts and sub-
  195.                               parts.
  196.                           -   Attach/remove handlers to ICanvas
  197.  
  198.                       o   Use the Class Editor to add the handler header files.
  199.  
  200.  
  201.                                Creating a Simple Calculator Application (V2)  3
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.                       o   Will learn functional concepts about the following
  212.                           parts:
  213.  
  214.                           -   Text Entry Field
  215.  
  216.                               -   Initialize
  217.                               -   Get/put data
  218.                               -   Maintain right justification
  219.  
  220.                           -   Multiline Edit Field (MLE)
  221.  
  222.                               -   Clear (Reset)
  223.                               -   Update (append line)
  224.                               -   Query (get) data
  225.                               -   Put data to ASCII flat file
  226.  
  227.                           -   Push buttons
  228.  
  229.                               -   Make labels connection parameters
  230.                               -   Connect to non-visual parts
  231.                               -   Connect to visual parts
  232.                                   o   Save Tally to File Dialog
  233.                                   o   Clear All to MLE
  234.  
  235.                           -   Imbedded views
  236.  
  237.                               -   How to use Visual Builder "variable"
  238.  
  239.                           -   File Dialog Box
  240.  
  241.                               -   How to connect to one (display)
  242.                               -   Get file name from one (name entered)
  243.                               -   How to handle "Cancel"
  244.                               -   Show filename syntax checking
  245.  
  246.                           -   Message Box
  247.  
  248.                               -   How to connect to one (display)
  249.                               -   How to use in conjunction with simple excep-
  250.                                   tion handling
  251.  
  252.                           -   Handlers
  253.  
  254.                               -   How to attach a handler to a control in the
  255.                                   Composition Editor
  256.                               -   How to add the associated handler .hpp
  257.                                   file(s) via the Class Editor
  258.  
  259.                       o   Test the completed application
  260.  
  261.                       o   Save the Calculator views.
  262.  
  263.  
  264.  
  265.  
  266.  
  267.                                Creating a Simple Calculator Application (V2)  4
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.   SPECIFICATION
  278.   _____________
  279.  
  280.                       This version of the calculator will have the following
  281.                       features:
  282.  
  283.                       o   The Display - a single line display used to display
  284.                           the numeric digits being entered.
  285.  
  286.                       o   The Tally Sheet - a multiple line display for holding
  287.                           a track of entered data, operators, functions, and
  288.                           calculations.
  289.  
  290.                       o   Display a message box when a divide by zero exception
  291.                           is detected.
  292.  
  293.                       o   A keypad with ten numeric keys (0-9).
  294.  
  295.                       o   Four arithmetic operator keys (+, -, *, /).
  296.  
  297.                       o   Four function keys (Clear, Clear All, =, Save Tally).
  298.  
  299.                       This version of the calculator will perform only integer
  300.                       arithmetic and does not support operator precedence.
  301.  
  302.                       As numeric keys are pushed, the appropriate numeric digit
  303.                       will be displayed in the rightmost position of the
  304.                       display.
  305.  
  306.                       Pressing an arithmetic operator key specifies the opera-
  307.                       tion to be performed on the current running total with
  308.                       the next number entered.  The tally sheet will be updated
  309.                       with the contents of the display, if any, and the symbol
  310.                       for the operator pressed.
  311.  
  312.                       When a function key is pressed, that function is per-
  313.                       formed immediately as defined below:
  314.  
  315.                       o   "=" means to evaluate and display the result of any
  316.                           pending operation/expression.  If there is nothing
  317.                           pending then this causes the last
  318.                           operation/expression to be evaluated and its result
  319.                           displayed.  For example, pressing the following push
  320.                           buttons (in the order listed), 7 + 2 =, will cause 7
  321.                           to be added to 2 and 9 to be displayed.  Pressing the
  322.                           equal push button two more times would result in 9 +
  323.                           2 being evaluated and 11 displayed, and then 11 + 2
  324.                           being evaluated and 13 displayed.
  325.  
  326.                       o   "Clear Display" means to reset the display to blank.
  327.  
  328.                       o   "Clear All" means to reset everything to zero.
  329.  
  330.                       o   "Save Tally" means to save the current tally sheet to
  331.                           a user designated ASCII flat file.
  332.  
  333.  
  334.                                Creating a Simple Calculator Application (V2)  5
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.                       END OF DOCUMENT
  345.                       _______________
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.                                Creating a Simple Calculator Application (V2)  6
  402.  
  403.  
  404.  
  405.