home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 18 REXX
/
18-REXX.zip
/
vrextras.zip
/
vrextras.INF
(
.txt
)
< prev
next >
Wrap
OS/2 Help File
|
1995-08-29
|
32KB
|
1,054 lines
ΓòÉΓòÉΓòÉ 1. VRExtras Object Pack ΓòÉΓòÉΓòÉ
The VRExtras Object Pack for VX-REXX contains 4 different objects that are
installed in the toolbar of VX-REXX:
o VRTransparentText object
o VRLine object
o VRFormattedEntryField object
o VRScroll object
ΓòÉΓòÉΓòÉ 1.1. Shareware Software ΓòÉΓòÉΓòÉ
DEFINITION OF SHAREWARE SOFTWARE
Shareware Software distribution gives users a chance to try software before
buying it. If you try a Shareware software program and continue using it, you
are expected to register. Individual programs differ on details -- some request
registration while others require it, some specify a maximum trial period.
With registration, you get anything from the simple right to continue using
the software to an updated program with printed manual.
Copyright laws apply to both Shareware and commercial software, and the
copyright holder retains all rights, with a few specific exceptions as stated
below. Shareware software authors are accomplished programmers, just like
commercial authors, and the programs are of comparable quality. (In both cases,
there are good programs and bad ones!) The main difference is in the method of
distribution. The author specifically grants the right to copy and distribute
the software, either to all and sundry or to a specific group. For example,
some authors require written permission before a commercial disk vendor may
copy their Shareware software.
Shareware software is a distribution method, not a type of software. You should
find software that suits your needs and pocketbook, whether it's commercial or
Shareware software. The Shareware software system makes fitting your needs
easier, because you can try before you buy. And because the overhead is low,
prices are low also. Shareware software has the ultimate money-back guarantee
-- if you don't use the product, you don't pay for it.
When you register the VRExtras Object Pack you will be sent a registered
version of the DLL by e-mail. This version has the "nag" popup removed and you
have the right to freely distribute software that includes the DLL.
If you are satisfied with the VRExtras Object Pack we ask you to freely
distribute the shareware version to your freinds and colleagues.
If you have any suggestions for enhancements or find any bugs in the software
please contact us at one of our Contact Addresses
ΓòÉΓòÉΓòÉ 1.2. Registering your license ΓòÉΓòÉΓòÉ
VRExtras is a "Shareware software program" and is provided at no charge to the
user for evaluation. Feel free to share it with your friends, but please do not
give it away altered or as part of another system. The essence of
"user-supported" software is to provide personal computer users with quality
software without high prices, and yet to provide incentive for programmers to
continue to develop new products. If you find this program useful and find that
you are using the VRExtras Object Pack and continue to use the VRExtras Object
Pack after a reasonable trial period of 30 days, you must make a registration
payment of $45.00 to ADD Consulting (CH).
You can register through the CompuServe Shareware Registration facility:
GO SWREG registration Number 7277
The registration fee will license one copy for use on any one computer at any
one time. You must treat this software just like a book. An example is that
this software may be used by any number of people and may be freely moved from
one computer location to another, so long as there is no possibility of it
being used at one location while it's being used at another. Just as a book
cannot be read by two different persons at the same time.
Payment of the registration fee gives you the right to distribute programs
that include the object and the DLL without paying any other "run-time"
licenses.
Site-License arrangements may be made by contacting ADD Consulting (CH).
ΓòÉΓòÉΓòÉ 1.3. Distributing the VRExtras Object Pack ΓòÉΓòÉΓòÉ
Anyone distributing the VRExtras Object Pack for any kind of remuneration must
first contact ADD Consulting (CH) at our address below for authorization. This
authorization will be automatically granted to distributors recognized by the
(ASP) as adhering to its guidelines for shareware distributors, and such
distributors may begin offering the VRExtras Object Pack immediately, however
ADD Consulting (CH) should still be advised so that the distributor can be kept
up-to-date with the latest version of the VRExtras Object Pack.
Registered users are free to distribute programs that use the the VRExtras
Object Pack with no additional run-time fees.
ΓòÉΓòÉΓòÉ 1.4. Contact Address ΓòÉΓòÉΓòÉ
You can contact ADD Consulting at the addresses below or on the OS/2 Other
Vendors on CompuServe (GO OS2AVEN) where all our products are supported.
ADD Consulting (CH)
Mr. Peter Kanis
Via Suro 9
CH-7403 RhДzБns
Switzerland
Tel: +41 (0)81 630 2011
Fax: +41 (0)81 630 2015
CompuServe: 100275,350 (Peter Kanis)
INTERNET: kanis@ibm.net
ADD Consulting (RUS)
Mr. Michael V. Schelkin
18-29 Molodezhnaya Street
Jukovsky
140160 Moscow Region
Russia
Tel: +7 095 556 8533
Internet: michael@schelkin.msk.ru
ΓòÉΓòÉΓòÉ 1.5. Rights And Limitations ΓòÉΓòÉΓòÉ
ADD Consulting makes no warranties as to the information in this guide.
Additionally, ADD Consulting is not responsible or liable for any loss or
damage of any kind resulting from use of this product.
The Software is protected by international copyright laws. All rights reserved.
No part of the computer program, documentation or related files may be
reproduced photocopied, stored on a retrieval system, or transmitted except as
provided by copyright law or by express permission of the copyright owner.
DISCLAIMER - AGREEMENT
Users of the VRExtras Object Pack shall accept this disclaimer of warranty:
ADD CONSULTING SUPPLIES THIS PRODUCT AS IS WITHOUT WARANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARANTIES OF
MERCANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. ADD CONSULTING ASSUMES NO
LIABILITY FOR DAMAGES, DIRECT OR CONSEQUENTIAL, WHICH MAY RESULT FROM THE USE
OF THE PRODUCT.
Some jurisdictions do not allow the exclusion or limitations for consequential
or incidental damages, so the above may not apply to you.
ΓòÉΓòÉΓòÉ 2. VRTransparentText object ΓòÉΓòÉΓòÉ
The Transparent Text Object is designed to help design panels for VX-REXX where
text is required overwriting an image.
The text within a Transparent Text Object can be justified both horizontally
and vertically and wrapped within the area of the object.
When you start a program that uses Transparent Text Objects there will be a
short delay before they are shown on the window. This is so that the objects
can obtain an image of the underlying window.
Note:
The background of the Transparent Text Object is NOT transparent in the design
environment: it will take on the background of the top window. This is due to
the behaviour of the VX-REXX design environment.
Warning:
The Transparent Text Object makes a copy of the image in the window over which
it lies, if you use many Transparent Text Objects the memory signature of your
program may increase noticeably.
ΓòÉΓòÉΓòÉ 3. VRTransparentText properties ΓòÉΓòÉΓòÉ
The Transparent Text Object has following specific properties:
o Justification
o SizeToText
o VertJustification
o WrapText
The Transparent Text Object also has the following standard properties:
o Caption
o ClassName
o ClipSiblings
o Enabled
o FirstChild
o Font
o ForeColor
o Height
o HelpTag
o HelpText
o HintText
o HWnd
o Left
o Name
o Painting
o Parent
o Query
o QueryColumns
o Self
o Sibling
o SiblingOrder
o Top
o UserData
o Visible
o Width
ΓòÉΓòÉΓòÉ 3.1. Justification ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> Justification - List ΓòÉΓòÉΓòÉ
Data Type
String
Possible Values
Left
Centered
Right
See Also
o SizeToText
o VertJustification
o WrapText
ΓòÉΓòÉΓòÉ <hidden> Justification - Description ΓòÉΓòÉΓòÉ
This property determines the horizontal justification of the text in the
object. It behaves in the same way as the Justification property of the
Descriptive Text Object.
ΓòÉΓòÉΓòÉ 3.2. SizeToText ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> SizeToText - List ΓòÉΓòÉΓòÉ
Data Type
Boolean
Possible Values
1 (true)
0 (false)
See Also
o Justification
o VertJustification
o WrapText
ΓòÉΓòÉΓòÉ <hidden> SizeToText - Description ΓòÉΓòÉΓòÉ
This property will have different effects on the appearance and behaviour of
the Transparent Text Object depending on the setting of the WrapText property.
If WrapText is on, then the size of the object will be adjusted to the nearest
fit to its current size.
If WrapText is off then the object will be sized in the same way as a
Descriptive Text Object.
ΓòÉΓòÉΓòÉ 3.3. VertJustification ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> VertJustification - List ΓòÉΓòÉΓòÉ
Data Type
String
Possible Values
Top
Centered
Bottom
See Also
o Justification
o SizeToText
o WrapText
ΓòÉΓòÉΓòÉ <hidden> VertJustification - Description ΓòÉΓòÉΓòÉ
This property determines how the text is justified vertically within the
object.
Note:
This property is only valid when WrapText is off. If WrapText is on, this
propety is always set to "Top".
ΓòÉΓòÉΓòÉ 3.4. WrapText ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> WrapText - List ΓòÉΓòÉΓòÉ
Data Type
Boolean
Possible Values
1 (true)
0 (false)
See Also
o Justification
o SizeToText
o VertJustification
ΓòÉΓòÉΓòÉ <hidden> WrapText - Description ΓòÉΓòÉΓòÉ
This property will cause the text in a Transparent Text Object to be wrapped
over several lines if it is too long to fit in the width of the object. If
SizeToText property is set, the object will resize to show the complete text.
Note:
If the object is not wide enough for a word in the text, this word will be cut.
ΓòÉΓòÉΓòÉ 4. VRTransparentText methods ΓòÉΓòÉΓòÉ
The Transparent Text Object has the following specific methods:
o Refresh
o TextLength
ΓòÉΓòÉΓòÉ 4.1. Refresh ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> Refresh method ΓòÉΓòÉΓòÉ
ok = VRMethod( object, "Refresh");
Returns
1 (true) if successful
0 (false) otherwise
ΓòÉΓòÉΓòÉ <hidden> Refresh - Description ΓòÉΓòÉΓòÉ
This method will hide the text in order to refresh the background and then
re-draw the text. You should call this method whenever the background of the
text changes. It is a good idea to include this method in the parent window
Resize event.
ΓòÉΓòÉΓòÉ 4.2. TextLength ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> TextLength method ΓòÉΓòÉΓòÉ
Len = VRMethod( object, "TextLength");
Returns
The length of the caption text
See Also
o Justification
o SizeToText
o WrapText
ΓòÉΓòÉΓòÉ <hidden> TextLength - Description ΓòÉΓòÉΓòÉ
This method will return the length of the caption text in TWIPS. You can then
use this to determine whether the text will fit in the space you have and the
modify the SizeToText and/or WrapText properties accordingly.
ΓòÉΓòÉΓòÉ 5. VRLine object ΓòÉΓòÉΓòÉ
The Line Object is a simple object allows you to draw horizontal or vertical
lines in a VX-REXX window.
The Line Object has no methods other than the standard methods available to any
VX-REXX object:
o DefineEvent
o InvokeHelp
o ListMethods
o ListProperties
o PostEvent
o StartDrag
ΓòÉΓòÉΓòÉ 6. VRLine properties ΓòÉΓòÉΓòÉ
The Line Object has the following specific properties:
o Direction
o LineColor
o Thickness
The Line Object also has the following standard properties:
o ClassName
o ClipSiblings
o Enabled
o FirstChild
o Height
o HelpTag
o HelpText
o HintText
o HWnd
o Left
o Name
o Painting
o Parent
o Self
o Sibling
o SiblingOrder
o Top
o UserData
o Visible
o Width
ΓòÉΓòÉΓòÉ 6.1. Direction ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> Direction - list ΓòÉΓòÉΓòÉ
Data Type
String
Possible Values
Horizontal
Vertical
See Also
o Thickness
ΓòÉΓòÉΓòÉ <hidden> Direction - Description ΓòÉΓòÉΓòÉ
Defines the direction of the line. When you change the Direction property, the
line will pivot around its top/left anchor point.
Note:
You can also use the first character of the word V or H to set the direction.
ΓòÉΓòÉΓòÉ 6.2. LineColor ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> LineColor - list ΓòÉΓòÉΓòÉ
Data Type
String
Possible Values
White
Black
Blue
Red
Pink
Green
Cyan
Yellow
DarkGray
DarkBlue
DarkRed
DarkPink
DarkGreen
DarkCyan
Brown
PaleGrey
<default>
ΓòÉΓòÉΓòÉ <hidden> LineColor - Description ΓòÉΓòÉΓòÉ
Sets the color of the line to any of the standard VX-REXX colours.
Note:
Using the "<default>" colour will make the line invisible.
ΓòÉΓòÉΓòÉ 6.3. Thickness ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> Thickness - list ΓòÉΓòÉΓòÉ
Data Type
Numeric
Possible Values
Any +ve integer
1mm = 56 TWIPS.
See Also
o Direction
ΓòÉΓòÉΓòÉ <hidden> Thickness - Description ΓòÉΓòÉΓòÉ
Defines the thickness of the line in TWIPS. This property will override the
Width property if the Direction is Vertical or the Height property if the
Direction is Horizontal.
ΓòÉΓòÉΓòÉ 7. VRFormattedEntryField object ΓòÉΓòÉΓòÉ
The Formatted Entry Field Object allows you to control the way data is entered
into a VX-REXX Entry Field. The Formatted Entry Field Object achieves this my
modifying the standard entry field properties and filtering the keyboard input.
Three predefined formatted fields are supplied (see FieldType):
o Date entry field
o Time entry field
o Currency entry field
Other than these you can define your own entry FieldMask using the available
Mask Characters
ΓòÉΓòÉΓòÉ 7.1. Mask Characters ΓòÉΓòÉΓòÉ
To help you define the allowable characters in a Formatted Entry Field, the
following characters are defined and reserved for creating input masks.
# Only numeric characters ( 0..9) and punctuation characters are
allowed at this position.
@ Any character can be entered at this position.
| Only non-numeric characters can be entered at this position.
ΓòÉΓòÉΓòÉ 8. VRFormattedEntryField properties ΓòÉΓòÉΓòÉ
The Formatted Entry Field Object inherits all the properties of the standard
Entry Field Object and adds the following properties:
o AllowSpaces
o FieldType
o ForceUpperCase
o FieldMask
o SpaceToZero
ΓòÉΓòÉΓòÉ 8.1. AllowSpaces ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> AllowSpaces - list ΓòÉΓòÉΓòÉ
Data Type
Boolean
Possible Values
1 (true)
0 (false)
See Also
o FieldMask
o SpaceToZero
ΓòÉΓòÉΓòÉ <hidden> AllowSpaces - Description ΓòÉΓòÉΓòÉ
This property specifies whether the <Space> character is allowed in the input
string. When set to 0, an error beep will be emmited if you type the <Space>
character.
ΓòÉΓòÉΓòÉ 8.2. FieldType ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> FieldType - list ΓòÉΓòÉΓòÉ
Data Type
String
Possible Values
Date
Time
Currency
User Defined
See Also
o AllowSpaces
o ForceUpperCase
o FieldMask
o SpaceToZero
ΓòÉΓòÉΓòÉ <hidden> FieldType - Description ΓòÉΓòÉΓòÉ
This property determines what type of entry field is created :
o Date the field will be formatted according to the current system date
format.
o Time the field will be formatted according to the current system time
format.
o Currency the field will be formatted according to the current system
currency format.
o User Defined the user defines the input FieldMask
ΓòÉΓòÉΓòÉ 8.3. ForceUpperCase ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> ForceUpper - List ΓòÉΓòÉΓòÉ
Data Type
Boolean
Possible Values
1 (true)
0 (false)
See Also
o AllowSpaces
o FieldMask
o SpaceToZero
ΓòÉΓòÉΓòÉ <hidden> ForceUpperCase - Description ΓòÉΓòÉΓòÉ
This property determines the allowed case of the characters entered into the
field. If it is set, all characters typed into the field will be forced to
upper case.
ΓòÉΓòÉΓòÉ 8.4. FieldMask ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> Mask - List ΓòÉΓòÉΓòÉ
Data Type
String
Possible Values
see Mask Characters
See Also
o AllowSpaces
o ForceUpperCase
o SpaceToZero
o Mask Characters
ΓòÉΓòÉΓòÉ <hidden> Mask - Description ΓòÉΓòÉΓòÉ
A string representation containing Mask Characters and literal characters.
Input to the field is only allowed over the Mask Characters, all literals will
remain untouched by editing.
ΓòÉΓòÉΓòÉ 8.5. SpaceToZero ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> SpaceToZero - list ΓòÉΓòÉΓòÉ
Data Type
Boolean
Possible Values
1 (true)
0 (false)
See Also
o AllowSpaces
o FieldMask
o ForceUpperCase
ΓòÉΓòÉΓòÉ <hidden> SpaceToZero - Description ΓòÉΓòÉΓòÉ
This property is for for numeric input fields. If set to 1 all spaces left in
the field will be converted to the number 0 when the focus is lost.
ΓòÉΓòÉΓòÉ 9. VRFormattedEntryField methods ΓòÉΓòÉΓòÉ
The Formatted Entry Field Object apart from the following specific methods, all
the standard Entry Field methods apply.
o ValidateField
ΓòÉΓòÉΓòÉ 9.1. ValidateField ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> ValidateField - method ΓòÉΓòÉΓòÉ
ok = VRMethod( object, "ValidateField");
Returns
1 (true) Field is valid
0 (false) Field is invalid
See Also
o FieldType
o Mask Characters
ΓòÉΓòÉΓòÉ <hidden> ValidateField - Description ΓòÉΓòÉΓòÉ
This method takes no parameters and only applies to Date or Time fields. It
will check whether the contents of the field are valid:
Months part <= 12
Days part in range for the month
Hours part <= 23
Minutes part <= 59
User defined and Currency fields are not validated, the method always
returning TRUE.
ΓòÉΓòÉΓòÉ 10. VRScroll object ΓòÉΓòÉΓòÉ
The Scroll Object allows you to add scrollbars to a frame window or to use them
as stand alone objects.
ΓòÉΓòÉΓòÉ 11. VRScroll Properties ΓòÉΓòÉΓòÉ
The Scroll Object has the following properties:
o FrameControl
o LineIncrement
o MaximumValue
o MinimumValue
o Orientation
o PageIncrement
o StandardSize
o ThumbSize
The current position of the slider in the scrollbar is available through the
Value property and can also be set using the Value property.
ΓòÉΓòÉΓòÉ 11.1. FrameControl ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> FrameControl - List ΓòÉΓòÉΓòÉ
Data Type
Boolean
Possible Values
1 (true)
0 (false)
See Also
o Orientation
o AttachToWindow
ΓòÉΓòÉΓòÉ <hidden> FrameControl - Description ΓòÉΓòÉΓòÉ
When set to 1, this property will cause the scrollbar to become a frame control
of its parent window in the runtime environment. The Scroll Object remains free
floating in the design environment.
ΓòÉΓòÉΓòÉ 11.2. LineIncrement ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> LineIncrement - List ΓòÉΓòÉΓòÉ
Data Type
Numeric
Possible Values
0 - 32737
See Also
o MaximumValue
o MinimumValue
o PageIncrement
o ThumbSize
ΓòÉΓòÉΓòÉ <hidden> LineIncrement - Description ΓòÉΓòÉΓòÉ
This value defines the incrementation/decrementation of the Value of the Scroll
Object when either the arrows are clicked or a cursor key is pressed.
This value should not be greater than the value in the MaximumValue property
and should normaly be less than that of the PageIncrement property.
ΓòÉΓòÉΓòÉ 11.3. MaximumValue ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> MaximumValue - List ΓòÉΓòÉΓòÉ
Data Type
Numeric
Possible Values
0 - 32737
See Also
o LineIncrement
o MinimumValue
o PageIncrement
o ThumbSize
ΓòÉΓòÉΓòÉ <hidden> MaximumValue - Description ΓòÉΓòÉΓòÉ
this property defines the maximum Value of the Scroll Object when the slider is
at the bottom or right of the scrollbar.
ΓòÉΓòÉΓòÉ 11.4. MinimumValue ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> MinimumValue - List ΓòÉΓòÉΓòÉ
Data Type
Numeric
Possible Values
0 - 32737
See Also
o LineIncrement
o MaximumValue
o PageIncrement
o ThumbSize
ΓòÉΓòÉΓòÉ <hidden> MinimumValue - Description ΓòÉΓòÉΓòÉ
this property defines the minimum Value of the Scroll Object when the slider is
at the top or left of the scrollbar.
ΓòÉΓòÉΓòÉ 11.5. Orientation ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> Orientation - List ΓòÉΓòÉΓòÉ
Data Type
String
Possible Values
Vertical (default)
Horizontal
See Also
o FrameControl
ΓòÉΓòÉΓòÉ <hidden> Orientation - Description ΓòÉΓòÉΓòÉ
This property defines the orientation of the Scroll Object. You can also set
this property using the first character of the word (V or H).
ΓòÉΓòÉΓòÉ 11.6. PageIncrement ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> PageIncrement ΓòÉΓòÉΓòÉ
Data Type
Numeric
Possible Values
0 - 32737
See Also
o LineIncrement
o MaximumValue
o MinimumValue
o ThumbSize
ΓòÉΓòÉΓòÉ <hidden> PageIncrement - Description ΓòÉΓòÉΓòÉ
This value defines the incrementation/decrementation of the Value of the Scroll
Object when either the bar is clicked or a pageup/pagedown key is pressed.
This value should not be greater than the value in the MaximumValue property
and should normaly be greater than that of the LineIncrement property.
ΓòÉΓòÉΓòÉ 11.7. StandardSize ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> StandardSize - List ΓòÉΓòÉΓòÉ
Data Type
Boolean
Possible Values
1 (true)
0 (false)
See Also
o Orientation
o FrameControl
ΓòÉΓòÉΓòÉ <hidden> StandardSize - Description ΓòÉΓòÉΓòÉ
This property is set by default making a Scroll Object that is dropped on a
window a sensible size. The property is ignored in the runtime environment if
the Scroll Object is a FrameControl.
ΓòÉΓòÉΓòÉ 11.8. ThumbSize ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> ThumbSize - List ΓòÉΓòÉΓòÉ
Data Type
Numeric
Possible Values
0 - 100
See Also
o LineIncrement
o MaximumValue
o MinimumValue
o PageIncrement
ΓòÉΓòÉΓòÉ <hidden> ThumbSize - Description ΓòÉΓòÉΓòÉ
This defines the proportion of the ScrollBar Objects's height or width that is
occupied by the slider as a percentage.
ΓòÉΓòÉΓòÉ 12. VRScroll Events ΓòÉΓòÉΓòÉ
The Scroll Object generates the following events when manipulated in the
runtime environment:
o Change
o Track
ΓòÉΓòÉΓòÉ 12.1. Change ΓòÉΓòÉΓòÉ
The change event is posted whenever the positon of the thumb bar is changed,
either by clicking the arrows, the bar itself or pressing a cursor key when the
Scroll Object has the focus. The Value property of the Scroll Object is updated
at the same time.
ΓòÉΓòÉΓòÉ 12.2. Track ΓòÉΓòÉΓòÉ
The track event is posted whenever the Scroll Object's slider is dragged. The
Value property of the Scroll Object is updated at the same time.
ΓòÉΓòÉΓòÉ 13. VRScroll Methods ΓòÉΓòÉΓòÉ
The Scroll Object exports the following method:
o AttachToWindow
ΓòÉΓòÉΓòÉ 13.1. AttachToWindow ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ <hidden> AttachToWindow method ΓòÉΓòÉΓòÉ
ok = VRMethod( object, "AttachToWindow");
Returns
1 (true) if successful
0 (false) if fails
See Also
o FrameControl
o Orientation
ΓòÉΓòÉΓòÉ <hidden> AttachToWindow - Description ΓòÉΓòÉΓòÉ
This method will attach the Scroll Object to the frame of its parent window as
a frame control. Once a Scroll Object has been converted to a frame control, it
cannot be moved or detached.
Note:
This method is called during the initialisation of a Scroll Object if the
FrameControl property is set. It should, therefore, rarely be necessary to call
this method.