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