|
TppRegion |
  
|
|
TppRegion |
|
Use the Region object to control whether items print or not and to give objects below the ability to move up if the region doesn't print. Generally you will put one or more TppDBText or TppLabel objects within a Region. Then, if you turn the Region off, none of the items within the region will print.
PALETTE ICON & EXAMPLE
PROPERTIES
The following are the properties that apply to this object. Some are defined in Common Properties and are linked to their appropriate page.
| Caption | This property will print in the upper left corner of the Region. If you don't want it to be printed you must clear the Caption property value. |
| Height | The heigth of the Region on the report form. If the Region is printed it will always take the size of the object on the form. |
| Left | The starting position of the Region indicator. If the Region is printed it will start where you have placed it on the form. |
| ParentHeight | If this is checked the Region will start at the top of the Band where it is placed, and stretch to the bottom. You will still be able to control the Width of the Region unless you have also checked the ParentWidth property. |
| ParentWidth | If this is checked the Region will start at the left side of the Band where it is placed, and stretch to the far right side. You will still be able to control the Height of the Region unless you have also checked the ParentHeight property. |
| ShiftRelativeTo | If you have multiple Regions in your Band, or a combination of SubReports and Regions you will want to set this value to the SubReport or Region that immediately preceeds this Region. By doing that this Region won't start printing until the other is done. If you don't do this it will overprint the other SubReport/Region. Also, if the previous SubReport/Region has nothing to print this Region will move up as you would expect. To choose the appropriate object just click on the down arrow in the property box and choose the name of the previous SubReport/Region. If there are no other SubReports or Regions in the Band you can ignore this property. |
| Stretch | If the Region contains a TppDBText object that can grow in length (AutoSize and WordWrap is checked) and you don't check this property, the Region will not grow as the number of lines printed grows. The default value is unchecked. |
| StretchWithParent | If the band the Region is placed on contains a TppDBText object that can grow in length (AutoSize and WordWrap is checked) and you don't check this property, the Region will not grow as the number of lines printed grows. The default value is unchecked. |
| Transparent | Checking this property would have the same effect as setting the Brush Color to Clear. The default value is unchecked. |
Example
To use this at runtime you would define an alpha field size 3 with the same
define region1 type A size 3
to turn the region on for printing the on and off have to be in caps.
region1 = 'ON'
Turn the region off
region1 = 'OFF'
Page url: http://www.cassoftware.com/tas/manual/tppregion.htm