home *** CD-ROM | disk | FTP | other *** search
/ Chip 2002 October / Chip_2002-10_cd1.bin / zkuste / delphi / kolekce / d6 / CLXPLAN.ZIP / clxplanner.txt < prev    next >
Text File  |  2002-07-17  |  6KB  |  172 lines
  1. **********************************************************************
  2. TPlanner 1.6 and TDBPlanner 1.4 for CLX : July 2002
  3.  
  4.  Copyright ⌐ 2001 - 2002 by TMS Software
  5.  E-mail: info@tmssoftware.com
  6.  Web : http://www.tmssoftware.com
  7. **********************************************************************
  8.  
  9. Delphi 6.0, C++Builder 6.0 - Kylix 1.0/2.0 interactive scheduling component
  10.  
  11. Files :
  12. -----
  13.   planclxd6.zip     : component files for Delphi 6.0
  14.   planclxc6.zip     : component files for C++Builder 6.0
  15.   tmsplank1.tar.gz  : component files for Kylix 1.0
  16.   tmsplank2.tar.gz  : component files for Kylix 2.0
  17.  
  18.  
  19. Release TPlanner 1.6 and TDBPlanner 1.4
  20. ---------------------------------------
  21.  
  22. Component for interactive scheduling.
  23. Features : 
  24.  
  25. - DB aware in day mode through TDBDaySource
  26. - Items that can be resized / repositioned.
  27. - Inplace multiline editable items
  28. - Items with multiple imagelist images
  29. - Items with caption time indication
  30. - Readonly items
  31. - Various display modes : day (5,6,10,15,30,60 min), week, month, multi day / multi resource mode, custom grid displays.
  32. - Controllable active day start, active day end, day start, day end
  33. - Events for insert, delete, left click, right click of items.
  34. - Overlapped / non overlapped items
  35. - HTML export.
  36. - Save to streams
  37. - Rich text planner items
  38. - 12/24 hrs time format
  39. - Header alignment / images / events
  40. - Printing
  41. - Layers
  42. - HTML formatted items
  43. - Linked items
  44. - Alarms
  45. - Support for spell checkers
  46.  
  47. Feature Revision history :
  48. --------------------------
  49.  
  50.    1.0  : first release
  51.    1.6  : compatibility release with TPlanner 1.6 for VCL and TDBPlanner 1.4 for VCL
  52.          
  53. Installation :
  54. --------------
  55.  
  56.  Delphi 6
  57.  
  58.   Open QPLANPKGD6.DPK 
  59.  
  60.   Choose Compile & Install from the package editor
  61.  
  62.  Kylix 1
  63.  
  64.   Open QPLANPKGK1.DPK 
  65.  
  66.   Choose Compile & Install from the package editor
  67.  
  68.  Kylix 2
  69.  
  70.   Open QPLANPKGK2.DPK 
  71.  
  72.   Choose Compile & Install from the package editor
  73.  
  74.  C++Builder 6
  75.  
  76.   Open QPLANPKGC6.DPK 
  77.  
  78.   Choose Compile & Install from the package editor
  79.  
  80.  
  81. Usage of TDBPlanner with TDBDaySource
  82. -------------------------------------
  83.  
  84. Create a database that has at least following fields :
  85.  
  86. - Start time : full date/time field
  87. - End time : full date/time field
  88. - Key : 40 char unique item key field
  89.  
  90. Additional fields :
  91. - Notes field : memo field holding the planner item text
  92. - Subject field : character field holding the planner item caption text
  93. - Resource field : numeric field holding the planner item position in dmMultiResource mode
  94.  
  95. Add a TDBDaySource component on the form and assign a datasource component to your used database.
  96. Set the applicable fields to the TDBDaySource fields properties
  97.  
  98. Set the Mode property : can be dmMultiDay for displaying multiple day data in multiple positions
  99. or dmMultiResource for multiple resources in multiple positions.
  100.  
  101. Set the day property to a valid date : this is the first day that will be displayed
  102. in the first position of the planner.
  103.  
  104. When other database fields need to be mapped to planner items, use the OnFieldsToItem and
  105. OnItemToFields event like below :
  106.  
  107.  procedure TForm1.DBDaySource1FieldsToItem(Sender: TObject; Fields: TFields;
  108.    Item: TPlannerItem);
  109.  begin
  110.    Item.Color := TColor(Fields.FieldByName('COLOR').AsInteger);
  111.    Item.CaptionBkg := Item.Color;
  112.    Item.ImageID := Fields.FieldByName('IMAGE').AsInteger;
  113.    if Fields.FieldByName('CAPTION').AsBoolean then
  114.      Item.CaptionType := ctTime
  115.    else
  116.      Item.CaptionType := ctNone;
  117.  end;
  118.  
  119.  
  120.  procedure TForm1.DBDaySource1ItemToFields(Sender: TObject; Fields: TFields;
  121.    Item: TPlannerItem);
  122.  begin
  123.    Fields.FieldByName('COLOR').AsInteger := Integer(Item.Color);
  124.    Fields.FieldByName('CAPTION').AsBoolean := Item.CaptionType = ctTime;
  125.    Fields.FieldByName('IMAGE').AsInteger := Item.ImageID;
  126.  end;
  127.  
  128. After this setup, the planner will automatically display the right items from the database
  129. in the planner and react to the navigator Next/Prev buttons.
  130.  
  131. To create, delete or update items at runtime use :
  132.  
  133. TPlanner.CreateItem: TPlannerItem;
  134.  
  135.  Creates a new item in the database and thus also on the planner. Set the properties of
  136.  the returned item. The full item settings are updated in the database with the Item.Update method.
  137.  
  138. TPlanner.FreeItem(APlannerItem: TPlannerItem);
  139.  
  140.  Removes the planner item from the database as well as the planner
  141.  
  142. TPlannerItem.Update
  143.  
  144.  After changing the planner item properties, use Item.Update to let the changes reflect in the
  145.  database.
  146.  
  147.        
  148.  
  149. License :
  150. -------
  151. This component is free for use in non-commercial applications, that is
  152. any software that is not being sold in one or another way or that does
  153. not generate income in any way by the use of the application.
  154. The component cannot be distruted in any other way except through free
  155. accessible Internet Web pages or ftp servers. The component can only
  156. be distributed on CD-ROM or other media with written autorization of the
  157. author.
  158.  
  159.  
  160. Help, hints, tips, bug reports :
  161. ------------------------------
  162. Send any remarks to : info@tmssoftware.com
  163. Please clearly state which Delphi or C++Builder version you are using
  164. and which version of the component you are using. In case of doubt,
  165. download the latest version first at http://www.tmssoftware.com
  166. When installing newer versions of the component, make sure to update
  167. all your form files that used the previous version of TPlanner
  168. before recompiling your application to make sure all new properties
  169. are available. You can update the form file by opening it, ignoring
  170. remarks about new properties and save the form. 
  171.  
  172.