VRTransparentText
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.
Properties
The Transparent Text Object has following specific properties:
oJustification oSizeToText oVertJustification oWrapText
The Transparent Text Object also has the following standard properties:
oCaption oClassName oClipSiblings oEnabled oFirstChild oFont oForeColor oHeight oHelpTag oHelpText oHintText oHWnd oLeft oName oPainting oParent oQuery oQueryColumns oSelf oSibling oSiblingOrder oTop oUserData oVisible oWidth
Methods
The Transparent Text Object has the following specific methods:
Refresh
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.
ok = VRMethod( object, "Refresh");
- Returns
- 1 (true) if successful
- 0 (false) otherwise
TextLength
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.
Len = VRMethod( object, "TextLength");
- Returns
- The length of the caption text
- See Also
- Justification
- SizeToText
- WrapText