home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / drdc010.zip / CONTR010.ZIP / Readme.txt < prev   
Text File  |  2001-12-01  |  4KB  |  107 lines
  1. User control for DrDialog V0.1.0
  2. --------------------------------
  3.  
  4. This Rexx DLL contains a new control for use with DrDialog.
  5. Use it by creating a user control when building your dialog
  6. in DrDialog. Have a look at the file Demo.res for more
  7. information.
  8.  
  9.  
  10. How to use it
  11. -------------
  12. In your init function register the new Rexx function "DRCtrlRegister"
  13. with Rexx and call it to register the new control with your DrDialog
  14. application. The control must be registered in every application because
  15. this call is local to the calling process.
  16.  
  17. NOTE:
  18.  
  19. The DLL must be in the current directory, the libpath
  20. or where the DrRexx.exe is.
  21.  
  22. The default DrDialog installation sets the working dir
  23. for DrRexx.exe to the installation directory. So loading may
  24. fail if you start your app with a double click. Copy
  25. the DLL to your DrDialog installation directory or change
  26. the working directory then.
  27.  
  28. /* Register the new function with Rexx */
  29. rc=RxFuncAdd("DRCtrlRegister", 'drusrctl' , "DRCtrlRegister")
  30.  
  31. /* Register the new control with your application */
  32. call DRCtrlRegister
  33.  
  34.  
  35. You may change the colors by using the Color() function of DrDialog: 
  36.  
  37. /* Change color of bar */
  38. call Color '-','#255 0 0'
  39. /*Change color of text */
  40. call Color '+','#255 255 255'
  41.  
  42.  
  43. You may change the font of the text by using the Font() function of DrDialog:
  44.  
  45. /* Change font to 18.Helv */
  46. call Font '18.Helv'
  47.  
  48.  
  49. The value of each bar may be set using the Text() function:
  50.  
  51. /* Set bar to 30% */
  52. call Text '30'
  53.  
  54.  
  55. The label of each bar may be set using the Text() function:
  56.  
  57. /* Set bar to 30% and label to '3 of 10' */
  58. call Text '30#3 of 10'
  59.  
  60. The first part of the text string must be the value the bar should be set to.
  61. Everything after the '#' is printed as the label on the bar. You may use
  62. any text for the label or no label at all. If you don't want a label only
  63. set the value.
  64.  
  65.  
  66. License
  67. -------
  68. /*
  69.  * Copyright (c) Chris Wohlgemuth 2001 
  70.  * All rights reserved.
  71.  *
  72.  * http://www.geocities.com/SiliconValley/Sector/5785/
  73.  * http://www.os2world.com/cdwriting
  74.  *
  75.  * Redistribution and use in source and binary forms, with or without
  76.  * modification, are permitted provided that the following conditions
  77.  * are met:
  78.  * 1. Redistributions of source code must retain the above copyright
  79.  *    notice, this list of conditions and the following disclaimer.
  80.  * 2. Redistributions in binary form must reproduce the above copyright
  81.  *    notice, this list of conditions and the following disclaimer in the
  82.  *    documentation and/or other materials provided with the distribution.
  83.  * 3. The authors name may not be used to endorse or promote products
  84.  *    derived from this software without specific prior written permission.
  85.  *
  86.  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND
  87.  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  88.  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  89.  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  90.  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  91.  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  92.  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  93.  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  94.  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  95.  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  96.  * SUCH DAMAGE.
  97.  *
  98.  */
  99.  
  100.  
  101. Author
  102. ------
  103. Copyright Chris Wohlgemuth 2001
  104.  
  105. http://www.geocities.com/SiliconValley/Sector/5785/
  106. http://www.os2world.com/cdwriting
  107.