home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / VISBUILD / DOODLE / README < prev    next >
Text File  |  1995-06-08  |  10KB  |  262 lines
  1. NAME: DOODLE
  2.  
  3. DESCRIPTION:
  4.        The DOODLE application is one of many 
  5.        applications that are being used to test the C++ 
  6.        Visual Builder.  It is included in this driver of the 
  7.        product as a sample for viewing, execution, and 
  8.        building purposes. 
  9.  
  10.        DOODLE consists of a set of visual parts, 
  11.        non-visual parts, and a resource DLL 
  12.        (CPPOV53R) that contains some bitmaps and 
  13.        pointers. 
  14.  
  15.        The visual parts (with exception of the 
  16.        DrawingArea) were built using the C++ Visual 
  17.        Builder Tool.  The application was created by 
  18.        connecting non-visual parts with the existing 
  19.        visual parts using the C++ Visual Builder.  The 
  20.        DrawingArea was written in standard C++ to 
  21.        show how to connect parts created with the 
  22.        C++ Visual Builder to parts that were not 
  23.        created with the C++ Visual Builder.  An 
  24.        interface file (DAREA.VBE) enables the C++ 
  25.        Visual Builder to surface the Drawing Area class 
  26.        as a non-visual part in the builder. 
  27.  
  28. TASK:
  29.        Build a simple Object Oriented 2-D Graphics Draw 
  30.        Application. 
  31.  
  32. CONCEPT/FEATURE:
  33.        DOODLE shows examples of: 
  34.  
  35.            How to use a Visual Builder "factory" 
  36.            How to use a Visual Builder "variable" 
  37.            How to connect to a window 
  38.            How to create a modal window 
  39.            How to pass in data to a window 
  40.            How to return data from a window 
  41.            How to validate range checking 
  42.            How to handle a "Cancel" button 
  43.            How to handle a "Set" button 
  44.            How to reuse a modal window 
  45.            How to use String, Long, Unsigned Long, 
  46.             Short, and Unsigned Short parts from 
  47.             VBSAMPLE.VBB 
  48.            How to use toolbars 
  49.            How to use toolbar buttons 
  50.            How to use auto-latching toolbar buttons 
  51.            How to use radio buttons 
  52.            How to use push buttons 
  53.            How to use a numeric spinbutton 
  54.            How to use sliders 
  55.            How to use text-entry fields 
  56.            How to use static text 
  57.            How to use colors 
  58.            How to connect non-builder generated code 
  59.             with builder generated code 
  60.  
  61. PROJECT LOCATION:
  62.        Inside the VisBuild Sample folder (inside the 
  63.        VisualAge C++ Samples folder). 
  64.  
  65. SOURCE FILE LOCATION:
  66.        X:\ibmcpp\samples\visbuild\doodle 
  67.  
  68.        where X: is the drive you installed the samples 
  69.        and document component of VisualAge C++. 
  70.  
  71.        Select Source Files for a list of the source files 
  72.        in this directory. 
  73.  
  74. HOW TO RUN THE SAMPLE:
  75.        
  76.        Note:  Before running this sample, you must add 
  77.        \ibmcpp\samples\visbuild\doodle to the 
  78.        LIBPATH in your CONFIG.SYS so the sample can 
  79.        find the CPPOV53R.DLL. 
  80.  
  81.        From within the WorkFrame environment: 
  82.                  To run the prebuilt project, open the 
  83.                  Samples folder on your OS/2 desktop 
  84.                  then double-click on the project's icon 
  85.                  to open the project view of the 
  86.                  sample.  Click on the RUN button of 
  87.                  the project's toolbar. 
  88.  
  89.        From the command line: 
  90.                  Simply type the name of the .EXE file, 
  91.                  that is: 
  92.  
  93.                    DOODLE
  94.                  
  95.  
  96. HOW TO BUILD THE SAMPLE PROJECT YOURSELF:
  97.  
  98.   Please Note Do not generate source from 
  99.   DAREA.VBB. This may overlay the prepared source 
  100.   code and will result in compile errors. 
  101.   
  102.        
  103.        From within the WorkFrame environment: 
  104.                  Open the Samples folder on your OS/2 
  105.                  desktop then double-click on the 
  106.                  project's icon to open the project view 
  107.                  of the sample. In the upper half of the 
  108.                  project window you will see the icons 
  109.                  of the files associated with the sample. 
  110.  
  111.                  Start the Visual Builder component of 
  112.                  VisualAge C++ by selecting Visual from 
  113.                  the Project pulldown.  From the main 
  114.                  Visual Builder Window: 
  115.  
  116.                    1. Select all the parts in the "Visual 
  117.                       Parts" list and then select 
  118.                       "Part->Generate->Part source" 
  119.                       from the Menubar. 
  120.                    2. Select only the " Doodle" part in 
  121.                       the "Visual Parts" list and then 
  122.                       select "Part->Generate->main() for 
  123.                       part" from the Menubar. 
  124.                    3. Now invoke a Project Build Action. 
  125.  
  126.                  To run the sample project, see How to 
  127.                  run the sample project above. 
  128.  
  129.        From the command line: 
  130.                  Start the Visual Builder component of 
  131.                  VisualAge C++ by typing: 
  132.  
  133.                    icsvb
  134.                  
  135.                  From the main Visual Builder Window: 
  136.  
  137.                    1. Select all the parts in the "Visual 
  138.                       Parts" list and then select 
  139.                       "Part->Generate->Part source" 
  140.                       from the Menubar. 
  141.                    2. Select only the "Doodle" part in 
  142.                       the "Visual Parts" list and then 
  143.                       select "Part->Generate->main() for 
  144.                       part" from the Menubar. 
  145.                    3. From an OS/2 command line, make 
  146.                       this sample's directory the current 
  147.                       directory and invoke the BUILD.CMD 
  148.                       program by typing: 
  149.  
  150.                         BUILD
  151.                       
  152.  
  153. HOW TO INSPECT THE VISUAL PARTS USING THE VISUAL BUILDER
  154.         
  155.          1. There are six "class files" that make up the 
  156.             application, DOODLE.VBB, CLRDLG.VBB, 
  157.             STYLDLG.VBB, TTLDLG.VBB, WDTHDLOG.VBB, 
  158.             and DAREA.VBB. 
  159.               a. Start the Visual Builder Tool -- from 
  160.                  the command line, type: 
  161.  
  162.                     icsvb
  163.                  
  164.                  or from the project view of the 
  165.                  sample:select Visual from the Project 
  166.                  pulldown. 
  167.               b. When the Visual Builder Window 
  168.                  appears, select from the Menubar the 
  169.                  "File->Load" option. On the Load Files 
  170.                  dialog page, set the dialog to the drive 
  171.                  and subdirectory that contain the 
  172.                  DOODLE application. Select from the list 
  173.                  the files DOODLE.VBB, CLRDLG.VBB, 
  174.                  STYLDLG.VBB, TTLDLG.VBB, and 
  175.                  WDTHDLOG.VBB and press the "OK" 
  176.                  button. 
  177.               c. In a similar manner to the previous 
  178.                  step, load DAREA.VBB from the 
  179.                  \ibmcpp\samples\visbuild\doodle\darea 
  180.                  directory, and VBSAMPLE.VBB from the  
  181.                  \ibmcpp\dde4vb directory. 
  182.               d. Now that you have loaded the 
  183.                  necessary files, from the "Loaded Part 
  184.                  Files" list in the Visual Builder Window 
  185.                  select DOODLE.VBB, CLRDLG.VBB, 
  186.                  STYLDLG.VBB, TTLDLG.VBB, and 
  187.                  WDTHDLOG.VBB. This will cause 
  188.                  "Doodle", "IColorDialog", "IStyleDialog", 
  189.                  "ITitleD ialog", and "IWidthDialog"  to 
  190.                  be displayed in the "Visuals" list of this 
  191.                  Window., 
  192.               e. You may now select any of these parts 
  193.                  from the "Visual Parts" list and then 
  194.                  select "Part->Open" from the Menubar 
  195.                  to open these parts for viewing and/or 
  196.                  editting.  (If you get a series of 
  197.                  "beeps" while the part is opening, 
  198.                  make sure that the resource DLL, 
  199.                  CPPOV53R, is in your LIBPATH.) 
  200.  
  201.             To inspect the DrawingArea part, you need 
  202.             to edit the DAREA.HPP and DAREA.CPP 
  203.             source files found in the DAREA 
  204.             subdirectory of this sample. 
  205.  
  206. SOFTWARE/HARDWARE PREREQUISITES:
  207.          
  208.            IBM VisualAge C++ 
  209.            OS/2 2.1 or Warp 
  210.            DB2/2 1.2 
  211.            IBM or compatible 486 and up. 
  212.  
  213. ADDITIONAL INFORMATION:
  214.          
  215.            For more information on the creation and 
  216.             use of projects in the WorkFrame 
  217.             environment, see the VisualAge C++ for 
  218.             OS/2 User's Guide. 
  219.            For more information on the the Visual 
  220.             Builder, see the VisualAge C++ for OS/2 
  221.             Visual Builder User's Guide. 
  222.  
  223.        Both books can be found online.  To access an 
  224.        online book, simply open the main VisualAge 
  225.        C++ desktop folder, then open the Information 
  226.        Folder inside.  To view a book, double-click on 
  227.        that book's icon. 
  228.   
  229. REQUIRED FILES:
  230.  
  231.   \ibmcpp\samples\visbuild\doodles directory 
  232.  
  233.   AVLTDOO1 SPC   High level specification of the calculator
  234.                  application. 
  235.   README         Description and instructions for sample. 
  236.   BUILD    CMD 
  237.   DOODLE   EXE   The executable application.
  238.   CPPOV53R DLL   DLL for the calculator application non-visual
  239.                  parts. 
  240.   DAREA    RCV 
  241.   DAREA_LI         DOODLE   MAK 
  242.                    CLRDLG   VBB 
  243.                    DOODLE   VBB 
  244.                    STYDLG   VBB 
  245.                    TTLDLG   VBB 
  246.                    WDTHDLOG VBB Visual Builder "class files" for 
  247.                                  the calculator application. 
  248.  
  249.   \ibmcpp\samples\visbuild\doodles\darea directory
  250.  
  251.   DAREA    CPP   C++ code files for the calculator non-visual parts.
  252.   DAREA    H     
  253.   DAREA    HPP   C++ header files for the calculator non-visual
  254.                  parts. 
  255.   DAREA    LIB 
  256.   DAREA    MAK 
  257.   DAREA    VBB   Visual Builder "class files" for the doodles
  258.                  application. 
  259.   DAREA    VBE   Non-visual Part Interface Definition Import file.
  260.   
  261.  
  262.