----------------------------------------------------------------

                        Slider VBX Control  

              Copyright 1995 Northeast Data Corp.

                     All Rights Reserved

----------------------------------------------------------------


   Release 2.6

   February 1995


This document describes the Slider Custom VBX Control. 


               CONTENTS

1. Product Description
2. Legal Information
3. Installation
4. Usage
5. Support
6. Version release notes

----------------------------------------------------------------

1. Product Description

The Slider VBX Control is a Microsoft Windows DLL designed and 
implemented in compliance with Microsoft standards for
interfacing with Visual Basic.

The control appears to the end user as a slider similar to those 
used on audio/video equipment such as stereos, tuners, and amplifiers.

To the application programmer, the interface to the slider is similar
to the one for the MS Windows standard scroll bar. The programmer can
set a range of values that will be fed back to the application as the
end user adjusts the position of the slider on its scale.

Being a VBX control, the programmer can add the Slider Control to the 
tool palette in Visual Basic. This allows use of the control in Visual
Basic forms. Since Visual C++ supports use of VBX controls, the slider
control can also be used in the Visual C++ environment.

Use of the Slider Control in a finished application requires the
Slider Control DLL (slider.vbx) to be installed with the application.
This is true of all custom controls written for MS Windows.

There are properties available that allow the programmer to control
the behavior and appearance of the Slider Control. The slider can appear
in a horizontal or vertical orientation. A horizontal slider can have top
"tick marks", bottom tick marks, no tick marks, or tick marks on both the
bottom and top. This is also true for vertical sliders, where tick marks
are left and right rather than top and bottom.

The range of the slider can be set to any range with low and high values
varying from 0 to 32767.

All communication between the Slider Control and the application is 
performed using the standard Windows message mechanism for controls. 
Design of the Slider Control message mechanism allows the application to
continuously monitor the setting of the control.


-------------------------------------------------------------------

2. Legal Information

The purchaser of the Slider Control is allowed to use it and
distribute it in applications without paying any royalty, and without
printing or displaying a copyright notice for the control. This only
includes distribution of the Slider Control DLL (SLIDER.VBX). It does 
not include distribution of documentation that comes with the Slider 
Control. 

The purchaser of the Slider Control may distribute the control DLL with
applications that are networked (multiple users accessing the DLL from
a file server) without paying any license fees to Northeast Data Corp.


-------------------------------------------------------------------

3. Installation

Create a "vbslider" (or other name of your choice) directory on your 
hard disk. Set your current directory to the slider directory and enter 
this command:

   PKUNZIP -d <floppy drive>\vbx\slider.zip

Note: The PKUNZIP utility is provided on the Slider installation disk 
in case you don't have it.

You may wish to copy the slider.vbx file to your windows\system directory,
since that is where .VBX files are normally placed.

Start Visual Basic or the Visual C++ App Studio applications and use
the custom control installation function to install the slider.vbx
control.


-------------------------------------------------------------------

4. Usage


PROPERTIES
----------

   BackColor - Sets the background color.

   BevelInner -  None (0), Inset (1), raised (2), or solid (3)

   BevelOuter - None (0), Inset(1), raised (2), or solid (3)

   BevelInnerWidth - The width of the inner bevel in pixels.

   BevelOuterWidth - The width of the outer bevel in pixels.

   BorderColor - Color of the border.

   BorderWidth - Width of the border in pixels.

   CtlName   - Name of the control.

   DragIcon  - Name of the icon that will appear when the control is dragged.

   DragMode  - Normal or automatic.

   Enabled   - Disables or enables the slider. 

   FocusPict - Bitmap to use for the thumb when it has focus. This bitmap
               should be the same size as the ThumbPict bitmap.
  
   Height    - Height of control.
 
   Index     - Index of control.

   Left      - Left position.
   
   Max       - Maximum slider value. This must be greater than the
               minimum slider value.

   Min       - Minimum slider value. This must be less than the maximum
               slider value.

   Picture   - A bitmap you can specify for painting the slider background.
               This picture must be a bit map. This bitmap will be positioned
               at the upper right corner of the control, inside the area
               specified by the BorderWidth and BevelWidth.

   Pos       - Current slider position. This must be a value between
               or including the current minimum and maximum values of
               the slider.

   Range     - Normal (0) or Inverted (1). If inverted, a vertical
               slider will increase in value from top to bottom and a
               horizontal slider will increase from right to left.

   TabIndex  - Control tab order.

   TabStop   - If this is turned on (1 instead of 0), the slider can
               be activated by tabbing to it with the TAB key.

   Tag       - Control tag.

   ThumbPict - Bitmap to use for the thumb. 

   TickMarks - Left, right, none or both for vertical sliders. 
               Top, bottom, none or both for horizontal sliders.

   TickStyle - 0 for black tick marks. 1 for inset marks, 2 for
               raised marks.

   Top       - Top of control window.

   Visible   - Visible/Invisible attribute.

   Width     - Width of control.

   
EVENTS
------

These events work the same way as for other VBX controls.

   Click
   DblClick 
   DragDrop  
   DragOver
   GotFocus
   KeyDown
   KeyUp
   LostFocus
   ThumbPos   
   ThumbUp

In order to update values in your application based on the current
position of the slider control, you should handle the ThumbPos AND
KeyDown events. The ThumbPos event is only sent when the user drags
the slider with the mouse. Cursor control keys cause the slider to
move but do no send ThumbPos events - they only send KeyDown and 
KeyUp events.

-----------------------------------------------------------------------

5. Support

For technical support, call 716-247-5934 from 8:00 a.m to 5:00 p.m
Monday through Friday. You may also send a FAX to this same number.


Release Notes
-------------

These notes pertain to the VBX and DLL versions of the control. Since
both versions are implemented in a common set of source code, there may
be new versions of the control with changes that affect the VBX, the DLL,
or both.

Version 2.3

   Added the standard Click event and the SB_ENDSCROLL notification
   message. (VBX and DLL)

Version 2.4

   Added the RClick event for sending an event when the right mouse
   button is clicked. (VBX only)

Version 2.5

   Rearranged properties to make control backward compatable with
   version 2.0. (VBX only)

Version 2.6

   Added the BorderColor property. Fixed problems with resizing the
   slider range ticks when the border sizes are changed.

