home *** CD-ROM | disk | FTP | other *** search
/ Programming Tool Box / SIMS_2.iso / vb_code2 / slider22 / readme.txt < prev    next >
Text File  |  1994-03-04  |  8KB  |  240 lines
  1. ----------------------------------------------------------------
  2.  
  3.                         Slider VBX Control  
  4.  
  5.               Copyright 1993 Northeast Data Corp.
  6.  
  7.                      All Rights Reserved
  8.  
  9. ----------------------------------------------------------------
  10.  
  11.  
  12.    Release 2.2
  13.  
  14.    March 1994
  15.  
  16.  
  17. This document describes the Slider Custom VBX Control. 
  18.  
  19.  
  20.                CONTENTS
  21.  
  22. 1. Product Description
  23. 2. Legal Information
  24. 3. Installation
  25. 4. Usage
  26. 5. Ordering Information
  27.  
  28. ----------------------------------------------------------------
  29.  
  30. 1. Product Description
  31.  
  32. The Slider VBX Control is a Microsoft Windows DLL designed and 
  33. implemented in compliance with Microsoft standards for
  34. interfacing with Visual Basic.
  35.  
  36. The control appears to the end user as a slider similar to those 
  37. used on audio/video equipment such as stereos, tuners, and amplifiers.
  38.  
  39. To the application programmer, the interface to the slider is similar
  40. to the one for the MS Windows standard scroll bar. The programmer can
  41. set a range of values that will be fed back to the application as the
  42. end user adjusts the position of the slider on its scale.
  43.  
  44. Being a VBX control, the programmer can add the Slider Control to the 
  45. tool palette in Visual Basic. This allows use of the control in Visual
  46. Basic forms. Since Visual C++ supports use of VBX controls, the slider
  47. control can also be used in the Visual C++ environment.
  48.  
  49. Use of the Slider Control in a finished application requires the
  50. Slider Control DLL (slider.vbx) to be installed with the application.
  51. This is true of all custom controls written for MS Windows.
  52.  
  53. There are properties available that allow the programmer to control
  54. the behavior and appearance of the Slider Control. The slider can appear
  55. in a horizontal or vertical orientation. A horizontal slider can have top
  56. "tick marks", bottom tick marks, no tick marks, or tick marks on both the
  57. bottom and top. This is also true for vertical sliders, where tick marks
  58. are left and right rather than top and bottom.
  59.  
  60. The range of the slider can be set to any range with low and high values
  61. varying from 0 to 32767.
  62.  
  63. All communication between the Slider Control and the application is 
  64. performed using the standard Windows message mechanism for controls. 
  65. Design of the Slider Control message mechanism allows the application to
  66. continuously monitor the setting of the control.
  67.  
  68.  
  69. -------------------------------------------------------------------
  70.  
  71. 2. Legal Information
  72.  
  73. The purchaser of the Slider Control is allowed to use it and
  74. distribute it in applications without paying any royalty, and without
  75. printing or displaying a copyright notice for the control. This only
  76. includes distribution of the Slider Control DLL (SLIDER.VBX). It does 
  77. not include distribution of documentation that comes with the Slider 
  78. Control. 
  79.  
  80. The purchaser of the Slider Control may distribute the control DLL with
  81. applications that are networked (multiple users accessing the DLL from
  82. a file server) without paying any license fees to Northeast Data Corp.
  83.  
  84.  
  85. -------------------------------------------------------------------
  86.  
  87. 3. Installation
  88.  
  89. Create a "slider" directory on your hard disk and copy all files from
  90. the distribution disk to the directory. These files include:
  91.  
  92.  
  93.    SLIDER.VBX       
  94.    SLDBACK.BMP       
  95.    FORM1.FRM       
  96.    PROJECT1.MAK       
  97.    THUMB1.BMP       
  98.    THUMBV1.BMP       
  99.    THUMB2.BMP       
  100.    THUMB3.BMP       
  101.    THUMB4.BMP       
  102.    THUMB4F.BMP       
  103.    THUMBV1F.BMP       
  104.    README.TXT       
  105.    PROJECT1.EXE 
  106.  
  107. If you have downloaded the slider.zip file from Compuserve, use
  108. PKUNZIP to extract the files into the directory.
  109.  
  110. Start Visual Basic or the Visual C++ App Studio applications and use
  111. the custom control installation function to install the slider.vbx
  112. control.
  113.  
  114.  
  115. -------------------------------------------------------------------
  116.  
  117. 4. Usage
  118.  
  119.  
  120. PROPERTIES
  121. ----------
  122.  
  123.    BackColor - Sets the background color.
  124.  
  125.    BevelInner -  None (0), Inset (1), raised (2), or solid (3)
  126.  
  127.    BevelOuter - None (0), Inset(1), raised (2), or solid (3)
  128.  
  129.    BevelInnerWidth - The width of the inner bevel in pixels.
  130.  
  131.    BevelOuterWidth - The width of the outer bevel in pixels.
  132.  
  133.    BorderWidth - Width of the border in pixels.
  134.  
  135.    CtlName   - Name of the control.
  136.  
  137.    DragIcon  - Name of the icon that will appear when the control is dragged.
  138.  
  139.    DragMode  - Normal or automatic.
  140.  
  141.    Enabled   - Disables or enables the slider. 
  142.  
  143.    FocusPict - Bitmap to use for the thumb when it has focus. This bitmap
  144.                should be the same size as the ThumbPict bitmap.
  145.   
  146.    Height    - Height of control.
  147.  
  148.    Index     - Index of control.
  149.  
  150.    Left      - Left position.
  151.    
  152.    Max       - Maximum slider value. This must be greater than the
  153.                minimum slider value.
  154.  
  155.    Min       - Minimum slider value. This must be less than the maximum
  156.                slider value.
  157.  
  158.    Picture   - A bitmap you can specify for painting the slider background.
  159.                This picture must be a bit map. This bitmap will be positioned
  160.                at the upper right corner of the control, inside the area
  161.                specified by the BorderWidth and BevelWidth.
  162.  
  163.    Pos       - Current slider position. This must be a value between
  164.                or including the current minimum and maximum values of
  165.                the slider.
  166.  
  167.    Range     - Normal (0) or Inverted (1). If inverted, a vertical
  168.                slider will increase in value from top to bottom and a
  169.                horizontal slider will increase from right to left.
  170.  
  171.    TabIndex  - Control tab order.
  172.  
  173.    TabStop   - If this is turned on (1 instead of 0), the slider can
  174.                be activated by tabbing to it with the TAB key.
  175.  
  176.    Tag       - Control tag.
  177.  
  178.    ThumbPict - Bitmap to use for the thumb. 
  179.  
  180.    TickMarks - Left, right, none or both for vertical sliders. 
  181.                Top, bottom, none or both for horizontal sliders.
  182.  
  183.    TickStyle - 0 for black tick marks. 1 for inset marks, 2 for
  184.                raised marks.
  185.  
  186.    Top       - Top of control window.
  187.  
  188.    Visible   - Visible/Invisible attribute.
  189.  
  190.    Width     - Width of control.
  191.  
  192.    
  193. EVENTS
  194. ------
  195.  
  196. These events work the same way as for other VBX controls.
  197.  
  198.    DblClick 
  199.    DragDrop  
  200.    DragOver
  201.    GotFocus
  202.    KeyDown
  203.    KeyUp
  204.    LostFocus
  205.    ThumbPos   
  206.    ThumbUp     - Occurs when the thumb has been dragged and is released.
  207.  
  208. In order to update values in your application based on the current
  209. position of the slider control, you should handle the ThumbPos AND
  210. KeyDown events. The ThumbPos event is only sent when the user drags
  211. the slider with the mouse. Cursor control keys cause the slider to
  212. move but do no send ThumbPos events - they only send KeyDown and 
  213. KeyUp events.
  214.  
  215.  
  216.  
  217. Ordering Information
  218. --------------------
  219.  
  220. To order the commercial version of the Slider Control, send a check to:
  221.  
  222.    Northeast Data Corp.
  223.    2117 Buffalo Rd., Suite 290
  224.    Rochester, NY  14624
  225.  
  226. The prices are:
  227.  
  228.    Slider VBX Control (for Visual Basic and Visual C++)  - $55
  229.    
  230.    Slider DLL Custom Control (for C)                     - $50
  231.  
  232.    Both controls                                         - $75
  233.  
  234.    Source code (includes both controls)                  - $219
  235.  
  236.  
  237. Include your phone number and Compuserve ID if applicable. In return for
  238. your check, you will get the software, a telephone number for support, and
  239. a Compuserve ID for support.
  240.