home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1998 January / Pcwk0198.iso / Dcomplib / ASSISTNT.LZH / ASSI.TXT < prev    next >
Text File  |  1997-03-16  |  6KB  |  173 lines
  1. TAssistent V1.1
  2. (C)1997 by Jens Rupp ( jens.rupp@stud.uni-erlangen.de )
  3.  
  4. This Software is Freeware!
  5. If you want the sourcode write me an E-Mail and answer this simple Qestions:
  6.  
  7. - Why do you want the Sourcecode (to make modifikations, to study the technique, to HAVE the  source etc)
  8. - In what Application will you use TAssistent (type,private,freeware,shareware,comercial etc)
  9. - What Improvements woud you like to see in the next Version ?
  10. - Have you found any BUGS ?
  11. - Where did you find it ?
  12.  
  13. I think this is a fair Deal.
  14.  
  15. Files Included in the archive:
  16.  
  17. assi16.dcu       Delphi 1 Component
  18. assi16.dcr       Delphi 1 Component resource
  19. button16.res     Delphi 1 Button resource
  20. assi32.dcu       Delphi 2 Component
  21. assi32.dcr       Delphi 2 Component resource
  22. button32.res     Delphi 2 Button resource
  23. assi.txt         This file
  24. history.txt      History of TAssistant
  25.  
  26. ADemo.dpr        Simple Demo project (works with Delphi 1 and 2)
  27. Ademo.res
  28. Main.pas
  29. Main.dfm
  30. Form.pas
  31. Form.dfm
  32. assi.bmp
  33.  
  34.  
  35. Step by step Instruction:
  36.  
  37. Creating the Dialog/Assistent form
  38. 1.  Install the component (assi16 for Delphi 1 and assi32 for Delphi 2)
  39. 2.  A Component Tab called Assistent appaears. It contains three Objects:
  40.     Tassistent, TAbox, TAGroupBox
  41. 3.  Start a new Project (Form1)
  42. 4.  Create a new empty Form (Form2)
  43. 5.  Put a Tassistent on Form2
  44. 6.  Put a button on Form1
  45. 7.  Double-click the button to create TForm1.Button1Click(Sender: TObject);
  46. 8.  Insert the following lines between begin and end:
  47.     form2.assistent1.page:=0;
  48.     form2.showmodal;
  49. 9.  Add Unit2 to the Uses line of Unit1
  50. 10. Compile it
  51.  
  52. To see the Dialog/Assistent press the Button.
  53. To Change between Dialog and Assistent Mode press the Button in the lower left
  54. Corner.
  55.  
  56. Adding Dialog Elements:
  57. 1.  Activate the Tassitent Component
  58. 2.  Put two TABox on the Assistent:
  59.     ******************************
  60.     *  ----------------------    *
  61.     *  | TABox1              |   *
  62.     *  ----------------------    *
  63.     *                            *
  64.     *  ----------------------    *
  65.     *  | TaBox2              |   *
  66.     *  ----------------------    *
  67.     *                            *
  68.     *----------------------------*
  69.     *Assistent   Cancel Back Next*
  70.     ******************************
  71. 3.  Put an Tedit in TaBox1 and TaBox2
  72. 4.  Activate TaBox1 and Change the AssistentPage Property to 1
  73. 5.  Activate TaBox2 and Change the AssistentPage Property to 2
  74. 6.  Click the Assistent Button (without Starting the Programm)
  75. 7.  Move TaBox1 to the center of the Assistent
  76. 8.  Click on Next (to change to page 2)
  77. 9.  Move Tabox2 to the center of the Assistent
  78. 10. Change back to Dialog Mode: the TaBoxes are at their original places
  79. 11. Start the Programm
  80.  
  81. In Dialog mode both Edit components are on the same page, one above the middle
  82. and one below. In Assistent mode the Edit components are on different Pages and
  83. in the middle.
  84.  
  85. Properties of Tassistent:
  86.  
  87. AssistentHeight,
  88. AssistentWidth        Size of the Form in Assistent Mode
  89.  
  90. ButtonWidth           Width of the Buttons
  91.  
  92. DialogHeight,
  93. DialogWidth           Size of the Form in Dialog Mode
  94.  
  95. EndEnabled            if True the Ok-Button is Enabled
  96.  
  97. NumPages              Number of Pages of the Assistent
  98.  
  99. Page                  Actual Page:
  100.                       0           Dialog
  101.                       1-NumPages  Assistent
  102.  
  103. ShowAssistentOK       If True an OK Button is shown in the lower right Corner of
  104.                       the Assistent. It can be disabled with the EndEnabled property.
  105.                       With this Button the user can end the Dialog befor reaching the
  106.                       last Page of the Assistent.
  107.  
  108. ShowChangeButton      If True the button to Change between Assistent and Dialog mode is
  109.                       visible.
  110.  
  111. ShowGlyph             If true the icons on the buttons are visible. To change the
  112.                       icons edit button16.res or button32.res and recompile
  113.                       (you need the source to do this)
  114.  
  115. ShowHelpButton        If True a Help button is shown
  116.  
  117. TextAssitentName      Text in the Caption of the Assistent. It is Formatted with the format
  118.                       command. First %d is the actual Page, second %d NumPages
  119.  
  120. TextAssistentOK,
  121. TextBack,
  122. TextCancel,
  123. TextChangeAssistent,
  124. TextChangeDialog,
  125. TextDialogOK,
  126. TextFinish,
  127. TextHelp,
  128. TextNext             Captions of the Buttons
  129.  
  130. TextDialogName       Text in the Caption of the Dialog
  131.  
  132. Events of Tassistent
  133.  
  134. CanPageChange:
  135.     TCanPageChange = function(sender:tassistent;fromPage,toPage:integer):boolean of object;
  136.     This Event is activated before a Page Switch.
  137.     fromPage,toPage:  0           Dialog
  138.                       1-NumPages  Assistent
  139.                       -1          Finish/Ok was Pressed
  140.     If the result is false the page is not switched.
  141.  
  142. OnPageChange:
  143.      TPageChangeEvent = procedure (sender:tassistent;page:integer) of object;
  144.      This Event is activated after a Page Switch.
  145.      page is the number of the activated page
  146.  
  147. OnHelpClick: activated if the Help Button is Pressed
  148.  
  149. Properties of TaBox
  150.  
  151. Aleft,Atop            Position in the Assistent
  152. Dleft,Dtop            Position in the Dialog
  153. AssitentPage          0            Show not in Assitent
  154.                       1-NumPages   Show in Assitent
  155.                       -1           Show on all Assistent Pages
  156. ShowOnDialog          If True it is shown in the Dialog
  157.  
  158. Properties of TaGroupBox
  159. see TaBox
  160.  
  161. Hints:
  162.  
  163. - the Form can have different sizes in Dialog and Asssitent mode
  164. - if youe set showAssistentOK on true and endenabled to False you can enable
  165.   the ok button in the canpagechange Event if all necessary data is available
  166.   before reaching the last page
  167. - if you only want an assistent you can disable the Change Button
  168. - you can put a Button in a tabox which jumps to a special Page
  169.   by setting the page property
  170. - to start the Form in Assitent mode set page to 1 before activating the Form
  171. - you can display Images by putting a timage in a tabox
  172.  
  173. Jens