home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / sibyl_cw.zip / ColorWheel.TXT < prev    next >
Text File  |  1998-07-27  |  2KB  |  59 lines
  1. TColorWheel dialog/component v1.01
  2. **********************************
  3.  
  4. The TColorWheel Dialog is a component based on source code released by
  5. Paul Ratcliffe (paulr@orac.clara.co.uk).  The component displays a dialog
  6. with the undocumented ColorWheel control and allows user to select a
  7. color with it.  The color selected is passed back via the color property
  8. and the undocumented wm_ColorWheelChanged message.
  9.  
  10. To install:
  11. -----------
  12. Unzip the component source in your component source directory (my
  13. directory is "drv:\sibyl\Components\...".  Compile the source, then move
  14. the ColorWheel.SPU to the Sibyl COMPNT directory.
  15. In Sibyl, choose 'Component', then 'install'.  Go to the COMPNT directory 
  16. and select 'ColorWheel.SPU'.  Select the TColorWheel component and click OK.
  17. The TColorWheel component/dialog will appear in a tab labeled 'Custom'.  To
  18. change the component location, edit the EXPORTS line in the source.
  19.  
  20. TColorWheel methods:
  21. --------------------
  22. Execute - Function returns TRUE if the dialog is successfully executed and
  23.           the color is changed from the initial starting color.  This 
  24.           method is the method used to run the dialog.
  25.  
  26. TColorWheel properties:
  27. -----------------------
  28. Color - Read/Write.  Property is available during runtime.  This property
  29.         is the color selected/shown by the color wheel.
  30.  
  31. DlgTitle - Read/Write.  Property is settable during design.  The property
  32.            defines the title shown on the dialog when executed.
  33.  
  34. Version - Read only (not stored).  Property is available during design.  
  35.           Property returns the current version of the TColorWheel component.
  36.  
  37. To use:
  38. -------
  39. Drop TColorWheel on form during design stage.  Note, the component is best 
  40. called from the main form.  To display dialog, call TColorWheel1.Execute.
  41. For example-
  42.  
  43.  Procedure TForm1.Button1OnClick (Sender: TObject);
  44.  Begin
  45.    IF ColorWheel1.Execute 
  46.     THEN Color := ColorWheel1.Color.lColor;
  47.  End;
  48.  
  49. To change the color wheel dialog, compiled the .RC file with RC.EXE then
  50. run the resulting .RES through the 'filter.exe' program.  Replace the 
  51. byte array in the source with the resulting output from 'filter.exe'.
  52.  
  53. TColorWheel should work with Warp V3, but is untested (I don't have
  54. V3 installed anymore).
  55.  
  56. Any comments, suggestions, bug fixes, feel free to contact me.
  57.  
  58. - Michael G. Slack (slack@ibm.net), 1998/07/27
  59.