


	Version 1.61 © 2005 by CapeSoft Software (Pty) Ltd www.capesoft.com Updated 27 February 2003

Contents
		License & Copyright
		Introduction
		Support
		Installation
		Adding a TickerTape to your Window
		Options for the TickerTape control
		Long Tapes & Multiple Tapes
		Example
		Version History

License & Copyright

This template is copyright © 2004 by CapeSoft Software (Pty) Ltd. None of the included files may be distributed. Your programs which use TickerTape can be distributed without any TickerTape royalties.

Each developer needs his own license to use TickerTape. (Need to buy more licenses?)

This product is provided as-is. Use it entirely at your own risk. Use of this product implies your acceptance of this, along with the recognition of copyright stated above. In no way will CapeSoft Software (Pty) Ltd, their employees or affiliates be liable for any way for any damages or business losses you may incur as a direct or indirect result of using this product.

Introduction

I wanted to be able to attract the users attention, with a rather long instruction message. Rather than just plonk it onto the screen, I wrote a small template control so I could have it scroll across the screen. This proved to be remarkably effective

Support

Your questions, comments and suggestions are welcome. Check our web page (www.capesoft.com) for new versions. You can also contact us in one of the following ways.

CapeSoft Support
	Email	support@capesoft.com
	Telephone	+27 21 715 4000
	Fax	+27 21 715 2535
	Post	PO Box 511, Plumstead, 7801, Cape Town, South Africa

TickerTape may be purchased for $15 from:

CapeSoft Sales
	Web	www.capesoft.com
	Email	sales@capesoft.com
	Telephone	+27 21 715 4000
	Fax	+27 21 715 2535
	Post	PO Box 511, Plumstead, 7801, Cape Town, South Africa

Buy Online
	Web	www.clarionshop.com

Installation

1) Run the supplied installation file.

Adding a TickerTape to your Window

Adding a TickerTape to your window is easy.

Open the window editor for the window.
Select Control Template from the Populate menu.
Select TickerTape from the Class Ticker.
Point to where you want the control to go on the screen, and click the Left mouse button.

At this point a rather bright, red and black, ticker tape control appears.

Options for the TickerTape Control

Setting the colors. The ticker tape is made up of 2 controls. A Panel control and a String control. The panel control defaults to Black, and the String to Red ( hey - it attracts attention <g> ). You can change the colors for either part by right-clicking on the control, selecting Properties, going to the Color tab, and setting the color.
Setting the Speed. Right click on the control ( any part is fine ) and select Actions. You can set the speed of the scrolling here. By default it is set to 10. This amount is in 100ths of a second, and represents the delay between each scroll. i.e. the default is 1 tenth of a second between scrolls. If this is to fast make this number bigger, if it's too slow make it smaller.
Setting the message. You can set the actual text for the message here as well - use 'quotes' for actual text, or a variable name. If you use a variable then you can change the text while the scrolling is happening.
Setting the Font. The string part of the control is a normal string. The default font is courier. You can change the font if you like. A Fixed-Pitch font, like courier, is recommended for smooth scrolling.
Setting the visual Control Width. By default the visible part of the string is 35 characters wide. To make the string longer, or shorter, do the following;
a) adjust the string length in the normal way from @35 to @nn where nn is the length you want.
b) adjust the size of the panel control (i.e. the background) to match.
c) Go to the Local Data button for this procedure, and change the length of the tt:ticker string from 35 to however long you want it.

Long Tapes & Multiple Tapes

By default the template will create a data variable for you called tt:tickertape which will be used on the screen. The length of this string is 32 characters.

If you want a longer string displayed, or if you want multiple tapes on the same window, then you must create your own local variable (call it say MyTape) and set it to the length you want. If you are creating multiple tapes then create a different variable for each tape.

See the example, DemoMultiple procedure for an example of this in action.

Example

There is an example in your \Clarion5\3rdParty\Examples\Ticker directory

Version History

Version 1.61: Released May 16 2002

Minor changes
Converted to .saf format

Version 1.6: Released March 2 2001

Added support for Clarion 5.5a
Added better support for variable messages.

Version 1.5: Released September 28 2000

Restricted Control to Window procedures
Added support for Multiple Tickers on a single window
Added support for long Ticker strings
Extended maximum message length to 1024 bytes.
Added support for speed validation; means that different tickers can go at different speeds on the same window.

Version 1.2: Released May 21 1999

Support added for Splash templates.

Version 1.0: Released Feb 18 1999

[End of document]

meatloaf@capesoft.com