   Help for Tips

Properties	Events

Registration Information

Order Form

Getting Custom Controls Written

Description

Tips provides Microsoft(r) style tool tips.  Small windows pop-up with bits of info when the user pauses the mouse over your controls.  No code required, just set the Tag properties.

File Name

TIPS1.VBX

Object Type

Tipsent

Remarks

When the Enabled property is set to True (default), Tips automatically showing tool tips.

Tips should be placed on all forms where its functionality is required (including MDI forms and children).  Tips can be placed directly on an MDI form.

At design time, Tips shows you what a tip will look like.  Set colors (BackColor and ForeColor) and font to get the look you desire.  Then, set the Tag properties of the controls you want tips for.  Tips will automatically display those Tags at run-time, when the mouse cursor pauses over the controls.

Distribution Note     When you develop and distribute an application that uses Tips, you should install the file TIPS1.VBX into the users Windows SYSTEM directory.  Tips has version information built into it.  So, during installation, you should ensure that you are not overwriting a newer version of Tips.


Properties

All of the properties that apply to this control are in this table.  Properties that have special meaning for this control or that only apply to this control are marked with an asterisk (*).

Align	FontStrikethru	Parent

BackColor	FontUnderline	Tag

Caption	ForeColor	*TipAlignment

Enabled	Height	Top

FontBold	Index	Width

FontItalic	*Interval	*XOffset

FontName	Left	*YOffset

FontSize	Name

Enabled is the default value for the control.


Events

All of the events that apply to this control are in this table.  Events that have special meaning for this control or that only apply to this control are marked with an asterisk (*).

*TipDisplay


TipAlignment Property

Description

Determines where the tip is displayed.

Usage

[form.][control.]TipAlignment[ = integer ]

Remarks

This property determines where the tip is placed relative to the cursor or the control.  It can be one of the following values:

Value	Description

0	Cursor

1	Cursor (follow) - the tip follows the cursor

2	Upper left corner of control

3	Upper center of control

4	Upper right corner of control

5	Left side of control

6	Center of control

7	Right side of control

8	Lower left corner of control

9	Lower center of control

10	Lower right corner of control

The XOffset and YOffset properties are used to modify the placement of the tip.

Data Type

Integer (enumerated)


Interval Property

Description

Determines how long the mouse must not move.

Usage

[form.][control.]Interval[ = long ]

Remarks

This property determines how long (in milliseconds) the mouse cursor must pause over a control before Tips displays a tip.

Data Type

Integer (long)


XOffset and YOffset Properties

Description

Determines where to place the tip at run-time.

Usage

[form.][control.]XOffset[ = integer ]

[form.][control.]YOffset[ = integer ]

Remarks

These properties determine where to place the tip when it's displayed at run-time.  These values are in pixels.  The tip is placed relative to the hot-spot of the mouse cursor.

Data Type

Integer


TipDisplay Event

Example

Description

Occurs when Tips is about to display a tip.

Syntax

Sub ctlname_TipDisplay (ControlName As String, HelpContextID As Long, Tag As String)

Remarks

This event only occurs if the Enabled property is set to True (default).  Also, this event only fires for the form that the control is on.  If there are multiple forms that need tool tips, you must place Tips on each one.

The argument ControlName  holds the name of the control the mouse has paused over.

The argument HelpContextID holds the HelpContextID property of the control selected.  This property can be set in the properties window at design-time.

The argument Tag holds the Tag property of the control selected.  This property can be set either at run-time or design-time.  This is the text used by Tips to display.  You can modify it in this event.  Blank Tags are not displayed.


TipDisplay Event Example

In this example, the tip displayed is the each controls name (except controls that begin with "Form"). To try this example, paste the code into the Declarations section of a form that contains a number of various controls and a Tips control.  Press F5.

Sub Tips1_TipDisplay (ControlName As String, HelpContextID As Long, Tag As String)

   If Left(ControlName,4) = "Form" Then

      Tag = ""

   Else

      Tag = ControlName

   End If

End Sub


Registration Information

Credits

Tips was written by James Shields.  Inquiries can be sent to 71231,2066 on CompuServe, or mabry@halcyon.com on Internet.  If you must send something via U.S. Mail, the address is:

Mabry Software

Post Office Box 31926

Seattle, WA  98103-1926

Registration

You can register this program by sending $15 ($17 for international orders) and your address.  CompuServe members may register by sending $10 and their account number (the registered version will be E-mailed to you).  CompuServe members may also register this package by going to the SWREG forum.  Tips is registered there.  Tipss registration ID number is 3482.

For your convenience, an order form has been provided that you can print out directly from help.

Source Code and Registration

Source code (which includes a registered copy) to this control is available for $50 ($55 for international orders).  With source code you get a registered version of the control.  If you are a CompuServe member, you may get the source code in the Software Registration forum (GO SWREG) for $45.  It's registration number is 3483.

Credit Card Orders

You can order this program with Mastercard, Visa, American Express, or Discover from Public (software) Library by calling 800-242-4775 or 713-524-6394 or by FAX to 713-524-6398 or by CompuServe E-mail to 71355,470.  You can also mail credit card orders to PsL at Post Office Box 35705; Houston, TX 77235-5705.  THESE NUMBERS ARE FOR CREDIT CARDS ONLY.

Tips's ID number for this service is 11579.  This is good for both the normal registered version, and the source code version.

Any questions about the status of the shipment of the order, refunds, registration options, product details, technical support, volume discounts, dealer pricing, site licenses, etc., must be directed to Mabry Software at 206-634-1443 or FAX at 206-632-0272.

To ensure that you get the latest version, PsL will notify us the day of your order and we will ship the product directly to you.

© Copyright 1994 by James Shields


Order Form
 Tips Order Form

Use the Print Topic.. command from the File menu to print this order form.

Mail this	Mabry Software

form to:	Post Office Box 31926

Seattle, WA  98103-1926

Phone: 206-634-1443

Fax: 206-632-0272

BBS: WinDev BBS 206-634-0783

CompuServe: 71231,2066

Internet: mabry@halcyon.com

Where did you get this copy of Tips?

____________________________________________________________________

Ship to:	____________________________________________________________________

____________________________________________________________________

____________________________________________________________________

____________________________________________________________________

____________________________________________________________________

Phone:	_________________________________________________________________

Fax:	_________________________________________________________________

E-Mail:	_________________________________________________________________

Disk Size:	(circle one)	 3½	5¼

qty ordered	____	REGISTRATION

$15 each, postpaid (check or money order in hard currency).  Foreign addresses add $2.00 shipping.  No additional shipping charges to Canada or Mexico.

qty ordered	____	SOURCE CODE AND REGISTRATION

$50 each, postpaid (check or money order in hard currency).  Foreign addresses add $5.00 shipping.  No additional shipping charges to Canada or Mexico.


Getting Custom Controls Written

If you or your organization would like to have custom controls written, you can contact me at the following:

James Shields

Mabry Software

Post Office Box 31926

Seattle, WA  98103-1926

Phone: 206-634-1443

Fax: 206-632-0272

BBS: WinDev BBS 206-634-0783

CompuServe: 71231,2066

Internet: mabry@halcyon.com

You can also contact Zane Thomas.  He can be reached at:

Zane Thomas

Post Office Box 300

Indianola, WA  98342

CompuServe: 72060,3327