home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / VISBUILD / DOODLE / AVLTDOO1.SPC next >
Text File  |  1995-05-08  |  8KB  |  468 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                                                           SPECIFICATION FOR THE
  14.                                                              DOODLE APPLICATION
  15.                                                                     VERSION 1.0
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                                                                     May 8, 1995
  24.  
  25.  
  26.                                                                             IBM
  27.  
  28.  
  29.                                                             RTP, North Carolina
  30.                                                                    avltdoo1.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.  
  73.   CONTENTS
  74.   ________
  75.  
  76.  
  77.  
  78.  
  79.  
  80.   CREATING A SIMPLE GRAPHICS DRAWING APPLICATION (V1)  . . . . . . . . . . .  1
  81.   What You Should Be Able To Do  . . . . . . . . . . . . . . . . . . . . . .  1
  82.   Specification  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
  83.  
  84.  
  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.  
  130.                                                                     Contents  2
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.   CREATING A SIMPLE GRAPHICS DRAWING APPLICATION (V1)
  141.   ___________________________________________________
  142.  
  143.  
  144.  
  145.  
  146.  
  147.   This scenario shows you how to build an application that uses the following:
  148.  
  149.   o   Modal windows
  150.  
  151.   o   Primitive parts
  152.  
  153.   o   Toolbars
  154.  
  155.   o   Toolbar buttons
  156.  
  157.   o   Radio buttons
  158.  
  159.   o   Push buttons
  160.  
  161.   o   Sliders
  162.  
  163.   o   Numeric spin buttons
  164.  
  165.   o   Text entry fields
  166.  
  167.   o   Static text
  168.  
  169.   o   Colors
  170.  
  171.   o   User provided parts
  172.  
  173.   o   Object factories
  174.  
  175.   o   Variables
  176.  
  177.   o   Parameterized connections
  178.  
  179.  
  180.   WHAT YOU SHOULD BE ABLE TO DO
  181.   _____________________________
  182.  
  183.   o   Start Visual Builder.
  184.  
  185.   o   Upgrade the V1 Doodle application.
  186.  
  187.   o   Import user provided part.
  188.  
  189.   o   Use the Public Interface Editor.
  190.  
  191.   o   Use the Composition Editor to update views of the V1 Doodle application.
  192.  
  193.       -   Add/remove visual and non-visual parts on the layout surface.
  194.       -   Add/remove user provided parts on the layout surface.
  195.       -   Make/change connections between parts and subparts.
  196.  
  197.  
  198.                          Creating a Simple Graphics Drawing Application (V1)  1
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.   o   Will learn functional concepts about the following parts:
  209.  
  210.       -   Modal windows (dialogs)
  211.  
  212.           -   How to use a Visual Builder "factory"
  213.           -   How to use a Visual Builder "variable"
  214.           -   How to connect to a window
  215.           -   How to create a modal window
  216.           -   How to pass in data to the window
  217.           -   How to return data from the window
  218.           -   How to validate by range checking
  219.           -   How to handle "Cancel"
  220.           -   How to handle "Set"
  221.           -   How to reuse a modal window
  222.  
  223.       -   Primitive parts
  224.  
  225.           -   Creating a part
  226.           -   Creating a variable
  227.           -   Setting limits
  228.           -   Setting default values
  229.           -   Creating conditional logic with connections
  230.           -   Performing range checking using parts
  231.  
  232.       -   Toolbars
  233.  
  234.           -   Locating
  235.           -   Horizontal orientation
  236.           -   Vertical orientation
  237.           -   Adding controls
  238.  
  239.       -   Toolbar buttons
  240.  
  241.           -   Latching
  242.           -   Autolatching in groups
  243.           -   Connect to non-visual parts
  244.           -   Specify button bitmaps
  245.  
  246.       -   Radio buttons
  247.  
  248.           -   Latching
  249.           -   Autolatching in groups
  250.           -   Connect to non-visual parts
  251.  
  252.       -   Push buttons
  253.  
  254.           -   Connect to non-visual parts
  255.           -   Connect to visual parts
  256.  
  257.       -   Sliders
  258.  
  259.           -   Initialize
  260.           -   Set range
  261.           -   Get/put data
  262.  
  263.  
  264.                          Creating a Simple Graphics Drawing Application (V1)  2
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.           -   Connect to non-visual parts
  275.  
  276.       -   Numeric spin buttons
  277.  
  278.           -   Initialize
  279.           -   Set range
  280.           -   Get/put data
  281.           -   Connect to non-visual parts
  282.  
  283.       -   Text entry fields
  284.  
  285.           -   Initialize
  286.           -   Get/put data
  287.           -   Set text limits
  288.  
  289.       -   Static text
  290.  
  291.           -   Initialize
  292.           -   Get/put data
  293.           -   Set colors
  294.           -   Connect to non-visual parts
  295.           -   Connect to visual parts
  296.  
  297.       -   Colors
  298.  
  299.           -   Initialize
  300.           -   Get/put data
  301.           -   Connect to non-visual parts
  302.           -   Connect to visual parts
  303.  
  304.   o   Test the completed application
  305.  
  306.   o   Save the Doodle views.
  307.  
  308.  
  309.   SPECIFICATION
  310.   _____________
  311.  
  312.   This version of the Doodle application will have the following features:
  313.  
  314.   o   The Drawing Area - a drawing canvas used to display drawn graphic objects
  315.       created with the defined graphic creation tools.
  316.  
  317.   o   The Drawing Tools Toolbar - contains selected object creation and manipu-
  318.       lation tools
  319.  
  320.   o   The Colors Toolbar - contains buttons for frame and fill color dialogs,
  321.       and direct color buttons for Red/Green/Blue fill.
  322.  
  323.   o   The Drawing Styles Toolbar - contains a button for drawing style dialog,
  324.       and direct button- indicators for frame & fill, frame only, and fill only
  325.       styles.
  326.  
  327.   o   The Pen Width Toolbar - contains a button for pen width dialog, and spin
  328.       button-indicator for pen width value.
  329.  
  330.  
  331.                          Creating a Simple Graphics Drawing Application (V1)  3
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.   o   The Titlebar Label Toolbar - contains a button for titlebar label dialog,
  342.       and text entry field for titlebar label.
  343.  
  344.   o   The Pen/Fill Color Dialog Window - contains sliders for Red/Green/Blue
  345.       components, numeric values, current color swatch, and set and cancel
  346.       buttons.
  347.  
  348.   o   The Pen Width Dialog Window - contains entry field for pen width, value
  349.       range checking, and set and cancel buttons.
  350.  
  351.   o   The Drawing Style Dialog Window - contains grouped radio buttons for
  352.       drawing style, and set and cancel buttons.
  353.  
  354.   o   The Titlebar Label Window - contains text entry field for titlebar label,
  355.       and set and cancel buttons.
  356.  
  357.   o   The Flyover Help Information - provides context-sensitive brief help
  358.       information for participating controls and windows in the Doodle applica-
  359.       tion.
  360.  
  361.   o   The Information Area - provides context-sensitive detailed help informa-
  362.       tion for participating controls and windows in the Doodle application.
  363.  
  364.   This version of the Doodle application will provide drawing tools to create a
  365.   variety of graphic objects.  Currently defined tools include:
  366.  
  367.   o   rectangle
  368.   o   ellipse
  369.   o   polygon
  370.   o   line
  371.   o   polyline
  372.   o   freehand
  373.  
  374.   Drawing style may be specified for an object:
  375.  
  376.   o   Frame and Fill
  377.   o   Frame only
  378.   o   Fill only
  379.  
  380.   Colors may be specified for an object's frame and fill.
  381.  
  382.   Pen width may be specified for an object's frame.
  383.  
  384.   Current values for drawing style, colors, and pen width are displayed in the
  385.   toolbars.
  386.  
  387.   An existing object may have new style attributes applied to it using the
  388.   stylecan tool.
  389.  
  390.   An existing object may be removed using the eraser tool.
  391.  
  392.   An existing object may be moved by two methods:
  393.  
  394.   o   Drag with mouse button 1 using move tool
  395.  
  396.  
  397.                          Creating a Simple Graphics Drawing Application (V1)  4
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.   o   Drag with mouse button 2 using any tool
  408.  
  409.   Additional tools may be added to the toolbar.  The drawing area has logic for
  410.   additional tools:
  411.  
  412.   o   arc
  413.   o   chord
  414.   o   pie
  415.   o   bitmap
  416.   o   text
  417.  
  418.   END OF DOCUMENT
  419.   _______________
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.                          Creating a Simple Graphics Drawing Application (V1)  5
  465.  
  466.  
  467.  
  468.