Mini Kabibi Habibi
/ @ �
==============================
Visual FoxPro 9-only Information Below
==============================
Fontcharset value for header record (default font for the report) and OBJTYPE 5 and 8 (Text and Expression).
This information is not included in records of OBJTYPE 23 (extra font resource records created for backward compatibility, now unused).
NB: This value is used only if value of the Double logical field for the same record is .T., indicating a fontcharset has been explicitly chosen.
Not applicable to VFP.
;Used to store information from the Title/Summary dialog:
Report Summary:
[X] Page Header : EJECTBEFOR = .T.
[X] Page Footer : EJECTAFTER = .T.
==============================
Visual FoxPro 9-only Information Below
==============================
Title/Summary dialog is now Optional Bands dialog. Not applicable to VFP.
Not applicable to VFP.
�Time stamp of the last time the object was changed. Not used by font, and DE-related objects or 2x-style printer driver setup info records.
==============================
Visual FoxPro 9-only Information Below
==============================
Visual FoxPro 9's REPORTBUILDER.APP gives you algorithms with which to derive a Fox-style time stamp value for this field and also to get a readable date string from this value. rThe OBJTYPE (FRX object type) is identified by the following values:
0 Comment
1 Report
2 Workarea (2.x reports)
3 Index (2.x reports)
4 Relation (2.x reports)
5 Label
6 Line
7 Rectangle / Shape
8 Field
9 Bandinfo
10 Group
17 Picture / OLE Bound
18 Variable
21 Printer Driver Setup (2.x reports)
23 Font resource
25 Data Environment
26 Cursor, Relation, or CursorAdapter (See Name field to determine which)
==============================
Visual FoxPro 9-only Information Below
==============================
Visual FoxPro 9 reserves OBJTYPEs of 49 and below for native use. Additional restrictions related to FRX extensibility based on OBJTYPE:
Header record (OBJTYPE 1) must always remain at top of file (recno() = 1). In general, users should not disturb the record order of native-OBJTYPE FRX records.
Users can add custom OBJTYPEs of 50 and above (limit: 99). Persistence of these records and their full contents by the Designer is assured. However, position (RECNO()) of these records is not guaranted; they will usually be positioned after all native OBJTYPE records after a Designer session.ion.si �Identifies the object's backstyle as opaque or transparent
0 = Opaque
1 = Transparent
MODE adds to the values above to indicate RTL as follows:
0 = LTR
2 = RTL
4 = Context
/Used when a record with a certain OBJTYPE needs more definition.
When OBJTYPE = 9 (a band), the following values are used:
0 = Title
1 = Page header
2 = Column header
3 = Group header
4 = Detail
5 = Group footer
6 = Column footer
7 = Page footer
8 = Summary
In the report definition record, OBJCODE = 53. For shapes, OBJCODE = 4. For other report layout objects and group records, the value is 0. For variables, 2x-style pdsetup records, the data environment record, and DE-related data objects, this value is blank.
For 2x-style data environment records of OBJTYPE = 2 (workarea), OBJCODE represents the workarea in which each table is opened.
For 2x-style index records (OBJTYPE = 3), OBJCODE represents the workarea for which the IDX is opened.
For 2x-style relation records (OBJTYPE = 4), OBJCODE represents the workarea matching the child of the relation.
==============================
Visual FoxPro 9-only Information Below
==============================
For OBJTYPE 9 (band info), these additional OBJCODE values are possible in Visual FoxPro 9:
9 = Detail header band
10 = Detail footer band
In native OBJTYPE records (< 50) users should not add OBJCODEs of undocumented or unknown values. Use and persistence of such records is not guaranteed.d. �The header record, Text-objects (OBJTYPEs 5 and 8) plus font resource records (OBJTYPE 23) use FONTFACE.
The default font name for the report appears both in the Report header record and a separate font resource record.
Additional font resource records appear each time you add a text object to the layout using a font that does not already occur in the report. A change to any characteristic of the font (for example, style) results in a new font resource record.
==============================
Visual FoxPro 9-only Information Below
==============================
Only one new font resource record is created for each font combination even if this font is used with more than one FontCharset value in the report. See DOUBLE and RESOID fields. �For Picture/Bound (OBJTYPE 17) records, Clip/Scale settings are stored here:
0 = Clip
1 = Scale Retain Shape
2 = Scale and fill frame
Not applicable to VFP.
�For the report definition (header) record, EXPR contains printer driver and print setup information.
For group headers, EXPR contains the group expression. Important note: contains nothing for group footers. If you need the group expression for a group footer, you must find the associated group header.
For Labels, EXPR contains the label caption.
For Fields, it contains the expression evaluated to provide output.
For a Report Variable, it contains the value or expression the Report Engine stores to this variable each time it moves the record pointer during a report pass.
For data environment and data object records, it contains the properties for those objects as name-value pairs; for instance, Alias = Cursor1.
EXPR is also used in 2x-style environment records. It contains the order expression when OBJTYPE=3 or the relation expression when OBJTYPE=4.
==============================
Visual FoxPro 9-only Information Below
==============================
Persistence limitation:
For header record (OBJTYPE 1), EXPR is reserved for internal use. Custom value-pairs added to this field will not be preserved by Report Designer sessions.
For detail bands (OBJTYPE 9, OBJCODE 4), EXPR contains the Target Alias expression.
For DE-related objects, EXPR may contain additional value-pairs in Visual FoxPro 9 to represent template DEClass and DEClasslibrary (Load Environment functionality) for these objects.s. 2In the report definition record, VPOS contains the number of columns in the report.
This field is left blank in band, variable, data environment, and data object records.
In font object records, it provides the character height in pixels, as in the first FONTMETRIC() attribute.
For a report layout object, VPOS contains the vertical position for this object within the layout.
For Group objects (OBJTYPE=10), VPOS contains the index of the first layout object in the group (See also HPOS).
==============================
Visual FoxPro 9-only Information Below
==============================
VPOS is essential for determining the relationships between objects and bands.
REPORTBUILDER.APP provides help for figuring out object-band relationships. "BandHints" are another possible extension. exten Not applicable to VFP.
�In the report definition record, HPOS contains the left margin in FRUs (an FRU=1/10,000 of an inch or 1/1,000 of a centimeter).
If the report has been defined for the printable page (Page Setup), this defaults to 0.000, and adjustments to this margin are relative to the printable page boundaries.
If the report is defined as using the whole page, this defaults to 2500.000 (a quarter inch), and the measurement is an absolute position in FRUs from the physical left margin.
In band, variable, data environment, and data object records, this value is blank blank.
For font object records, HPOS provides the average character width in pixels, as in the sixth FONTMETRIC() attribute.
For report layout object records, HPOS contains relative horizontal placement in the layout.
For Group objects (OBJTYPE=10), HPOS contains the number of layout objects in the group, stored consecutively in the FRX from the start of the group
(See also VPOS.)
hHEIGHT stores the height of layout objects.
In the report header, column spacing is stored here.
�In 2.x objects, STYLE is used to identify text object style with the following possible values:
B P_BOLD
I P_ITALIC
R P_RAISED
L P_LOWERED
J P_RIGHTALIGN
C P_CENTERALIGN
STYLE is not used in VFP.
==============================
Visual FoxPro 9-only Information Below
==============================
Reserved for template class and classlib, and additional reporting MemberData, for both design (Builder) and runtime (Listener) uses. RSUPEXPR contains Print When expression (corresponds to Print When dialog box).
�Indicates whether the object should be printed when detail overflows.
In the Print When dialog, Also print:
[ ] When detail overflows to new page/column: SUPOVFLOW=.F.
[X] When detail overflows to new page/column: SUPOVFLOW=.T.
�SYS(2015)-like unique identifier for most FRX records. Not used for comment, font object, data environment, or data objects (OBJTYPEs 0, 23, 25, and 26).
==============================
Visual FoxPro 9-only Information Below
==============================
Visual FoxPro 9 persistence limitation:
User-added records of OBJTYPEs > 49 and extra content in records with native OBJTYPEs (< 50) without UNIQUEIDs are not preserved by the Report Designer. �Not applicable to VFP for Windows 6.0 through 8.0.
==============================
Visual FoxPro 9-only Information Below
==============================
ORDER holds a character value representing a numeric value (summed binary flags), used for Protection. Natively-understood settings for these flags include:
1 Lock
2 Hide
4 Delete
8 Edit
16 AddObjects [Band only]
32 RemoveObjects [Band only]
Additional/custom settings may be added and interpreted by custom Report Builders.t B Not applicable to VFP.
UNIQUE is .T. in the Report Header: if this is a temporary, wizard-generated report
UNIQUE is set .T. in Report Variable records to represent Release after report
UNIQUE was also used in 2.x-style data environment setting (OBJTYPE = 3, indexes).
�You can use the COMMENT field to store developer's comments about an FRX record.
You can also add separate records of OBJTYPE 0 to store comments in an FRX, or add records with other PLATFORM values (even the value "COMMENT") to store information.
VFP ignores records that do not have recognized PLATFORM values, and also considers records with OBJTYPE 0 to be "comment records".
�ENVIRON is used in the OBJTYPE 25 (DataEnvironment) record to indicate whether a private data session should be used.
==============================
Visual FoxPro 9-only Information Below
==============================
=======
�Not applicable to VFP.
==============================
Visual FoxPro 9-only Information Below
==============================
=======
�For report expressions (ObjType = 8) FILLCHAR specifies the data type {'N', 'C', 'D'}.
==============================
Visual FoxPro 9-only Information Below
==============================
=======
~For Fields (OBJTYPE = 8), OFFSET specifies justification:
0 = Left (default for character and date-type expressions)
1 = Right align (default for numeric-type expressions)
2 = Center align
For Shapes (OBJTYPE = 7) , OFFSET specifies % curvature:
square boxes: 0
rounded boxes: 0-99 where 99 = elipse/circle.
The default dialog uses presets {12,16,24,32,99}.
For Picture/Bound (OBJTYPE 17), OFFSET specifies whether Filename or General field is used as image source:
0 = Filename (stored in PICTURE field)
1 = General field (stored in NAME field)
2 = Expression (stored in NAME field)
Not applicable to VFP.
Not applicable to VFP.
KThe value of PLATFORM is always "WINDOWS" in all natively-added records.
Users can add records with containing different values in this field. The Report Designer preserves their contents according to the same rules that it preserves contents in other records (these rules vary by OBJTYPE). The Report Engine ignores their contents.
==============================
Visual FoxPro 9-only Information Below
==============================
NB: complete contents of records with values not "WINDOWS" in this field are preserved by Visual FoxPro 9, including user-added fields.
uPENRED specifies the red saturation of the foreground color for text object, in RGB. It provides the pen color for Text and Expression objects (OBJTYPEs 5 and 8).
This value uses the RGB-friendly numeric form of the color (same as you would get from GETCOLOR()), except when it has its default value (-1).
For Font record, PENRED also provides FONTMETRIC(3).
�PENGREEN specifies the green saturation of the foreground color. See PENRED.
For Font record, PENGREEN also provides FONTMETRIC(5).
NPENBLUE specifies the blue saturation of the foreground color.
See PENRED. FILLRED specifies the red saturation of the background color. It provides fill color for text objects (OBJTYPEs 5 and 8).
FILLRED uses the RGB-friendly numeric form of the color (same as you would get from GETCOLOR()), except when it has its default value (-1).
KSpecifies the green saturation of the background color.
See FILLRED.
JSpecifies the blue saturation of the background color.
See FILLRED.
}PENSIZE specifies the width of the line for Line objects and Shape borders, using the following point size values:
0 = "hairline"
1 = 1 point
2 = 2 points
4 = 4 points
6 = 6 points
Other values are not supported, even though some may appear to work.
The full line thickness will not be visible unless the HEIGHT (or WIDTH) is set to (PENSIZE x 104.167)
vPENPAT specifies the line pattern for Line and Shape objects, using the following values:
0 = none/invisible
1 = dotted
2 = dashed
3 = dash-dot
4 = dash-dot-dot
8 = normal/solid
The following values appear to work but have unpredictable results on printed output:
5 = dotted (alternate style)
6 = dotted (alternate style 2)
7 = dotted (alternate style 3)
Identifies the fill pattern for Shape records:
0 = None
1 = Solid
2 = Horizontal lines
3 = Vertical lines
4 = Diagonal lines, leaning left
5 = Diagonal lines, leaning right
6 = Grid (horizontal and vertical lines)
7 = Hatch (left and right diagonal lines)
�USER is reserved for user comments. In VFP8 and under, will be overwritten to a blank by subsequent Report Designer sessions. Neither the Report Designer nor the Report Engine ever use the contents of the USER field.
==============================
Visual FoxPro 9-only Information Below
==============================
USER is exposed by default Report Builder interface, when MODI REPO without PROTECTED keyword is used.rd is use �See FONTFACE.
The basic FONTSTYLE values are:
0 = Normal
1 = Bold
2 = Italic
4 = Underlined
128 = Strikethrough
These values may be added to one another for combined effects. For example, a value of 5 = Bold and Underlined.
;Specifies the font size. See notes in FONTFACE record.
�Specifies the spacing between lines of text objects (OBJTYPE = 5).
0 = Single
1 = 1.5 lines
2 = Double
Always filled with 0 for expression objects (OBJTYPE = 8)
�Used in the header record only.
RULER specifies 0 if the ruler is not displayed.
Non-zero values will display the ruler graduated in specific measurement units:
0 - Off
1 - Inches
2 - Metric/CM
3 - Pixels
4 - Characters (1/12")
5 and greater - pixels
==============================
Visual FoxPro 9-only Information Below
==============================
Additional allowable values (5-9) will go to System default if used, may be used in the future for additional coordinate systems.te mGRIDH is used only in the header record. It specifies the horizontal spacing of the grid lines in pixels
dGRID is used only in the header record. It indicates whether objects on the report snap to grid
jGRIDV is used only in the header record. It specifies the vertical spacing of the grid lines in pixels.
�FLOAT indicates whether the object floats (stretches relative to the size of the surrounding fields). This value is used in combination with BOTTOM and TOP.
In Object Property dialog:
Object Position:
(*) Float : FLOAT = .T.
else FLOAT = .F.
oSTRETCH indicates whether the object stretches (expands vertically to display all data). This value is used in combination with STRETCHTOP.
In Object Property dialog, Stretch Downwards:
(*) No Stretch : STRETCH = .F.
(*) Stretch relative to tallest object : STRETCH = .F.
(*) Stretch relative to height of band : STRETCH = .T.
cIndicates whether the object stretches relative to the top of the band. This value is used in combination with STRETCH.
In Object Property dialog, Stretch Downwards:
(*) No Stretch : STRETCHTOP = .F.
(*) Stretch relative to tallest object : STRETCHTOP = .T.
(*) Stretch relative to height of band : STRETCHTOP = .T.
oIndicates whether the object is positioned relative to the top of the band. This value is used in combination with BOTTOM and FLOAT.
For objects, in the Object Property dialog, Object Position:
(*) Fix relative to top of band: TOP = .T.
else TOP = .F.
In the Report header record, TOP stores the Print Area:
Printable Page = .F.
Whole Page = .T.
hIndicates whether object is positioned relative to the bottom of the band. This value is used in combination with FLOAT and TOP.
In Object Property dialog, Object Position:
(*) Fix relative to bottom of band: BOTTOM = .T.
else BOTTOM = .F.
For Report Header: stores the Column Print Order:
Up-Down = .F.
Left-Right = .T. (Label-Style)
�Indicates whether page number is reset to 1 for each group.
==============================
Visual FoxPro 9-only Information Below
==============================
Now used for detail bands as well as group bands.roup bands. �Indicates whether the object suppresses repeated values -- that is, whether the object is printed when it matches the data of the same field in the preceding record.
For objects, Print When dialog:
[X] Remove line if blank : NOREPEAT = .T.
==============================
Visual FoxPro 9-only Information Below
==============================
For Detail Bands:
[X] Reprint detail header on each page: NOREPEAT = .T.EPEAT = KIndicates whether each Group is started on a new page, in both Group Header and Group Footer records (the pairs should always match). Also applies to new page for Title, Summary bands.
==============================
Visual FoxPro 9-only Information Below
==============================
Now also applies to detail band sets. band sets. 2Indicates whether each Group is started in a new column, in both Group Header and Footer records (the pairs should match). Also .T. for Summary band records .
==============================
Visual FoxPro 9-only Information Below
==============================
Now also applies to detail band sets. band :Indicates whether the object is centered, in OBJTYPE=17 (image) records.
==============================
Visual FoxPro 9-only Information Below
==============================
Indicates that a FontCharset has been explicitly assigned for the font information in this record (for the Header record, Text and Expression objects). Visual FoxPro 9 assigns the value .T. to all font-using records that it creates.
If this value is .T., information in RESOID provides numeric FontCharset, with 0 representing Western, 1 representing locale default. If it is .F., no FontCharset has been assigned explicitly, so 0 and 1 both represent locale default (backward compatible behavior).
This information is not included in records of OBJTYPE 23 (extra font resource records created for backward compatibility, now unused).
lity, now unused).
8Used to store information from the Title/Summary dialog:
Report Summary:
[X] Page Header : EJECTBEFOR = .T.
[X] Page Footer : EJECTAFTER = .T.
==============================
Visual FoxPro 9-only Information Below
==============================
The Title/Summary dialog is now Optional Bands. LSpecifies when the object should be printed when this group changes.
In the Print When dialog, Also print:
[ ] When this group changes: [ ] SUPGROUP = 0
[X] When this group changes: [GrpA ] SUPGROUP = 6
[X] When this group changes: [GrpB ] SUPGROUP = 7
:
Values 6,7, etc are indexes into the Group collection.
tFor Bands: [X] Constant Band Height: .T.
==============================
Visual FoxPro 9-only Information Below
==============================
The Expression Builder Options Field Aliases option is enabled in Visual FoxPro 9.
A .T. value in the PLAIN column of the header record takes precedence over the value of ADDALIAS, meaning "Add non-selected alias only".". %Indicates whether the object should not be printed on every band (corresponds to Print When dialog box).
In the Print When dialog,
Print repeated values (*) Yes : SUPVALCHNG=.F.
Print repeated values (*) No : SUPVALCHNG=.T.
SUPVALCHNG is used in combination with SUPALWAYS.
�If ADDALIAS is .T. in the header record, Always Add Alias is chosen in the (disabled) Expression Builder Options dialog.
If ADDALIAS is .F. in the header record, Never Add Alias is chosen in the (disabled) Expression Builder Options dialog.
==============================
Visual FoxPro 9-only Information Below
==============================
The Expression Builder Options Field Aliases option is enabled in the Visual FoxPro 9 Report Designer. (Previously, setting the values as above would work, but you could set them only by writing directly to the FRX.)
A .T. value in the PLAIN column of the header record takes precedence over the value of ADDALIAS, and indicates "Add non-selected alias only".". cIndicates whether the object suppresses repeated values -- that is, whether the object is printed when it matches the data of the same field in the preceding record.
In the Print When dialog:
Print repeated values (*) Yes : SUPALWAYS=.T.
Print repeated values (*) No : SUPALWAYS=.F.
This value is used in combination with SUPVALCHNG.
TOTALTYPE applies to calculated report fields and report variables. This is the type of calculation done.
The values are:
0 = Nothing
1 = Count
2 = Sum
3 = Average
4 = Lowest
5 = Highest
6 = Standard deviation
7 = Standard variance
�RESETTOTAL specifies when to reset report variables and calculated report fields for totals (e.g., at the end of a page or at the end of a report).
The default value is 1. The full range of fixed values for VFP 8 and earlier is:
1 = At end of report (for report variables); innermost group (for field/expressions)
2 = At end of page
3 = At end of column
Groups are indicated as 5 + group number. So:
6 = first Group
7 = second Group
:
==============================
Visual FoxPro 9-only Information Below
==============================
Calculated values can now be reset on Detail bands as well as groups.
Detail bands are indicated as 79 + detail number. So:
80 = first detail band
81 = second detail band
:
When TOTALTYPE = 0 (none), RESETTOTAL=1 means different things for Calculated Field/Expressions vs. Report Variables.
For Report Variables:
RESETTOTAL=1 means Reset at End of Report
For Calculated Field/Expressions (one detail band):
RESETTOTAL=1 means Reset at Innermost Group Band
For Calculated Field/Expressions (multi-detail bands):
RESETTOTAL=1 means Reset at object's detail banddetail band �A value of 3 in SUPRPCOL indicates the object should be printed on each new page/column.
In the Print When dialog, Also print:
[X] In first whole band of new page/column: SUPRPCOL = 3
[ ] In first whole band of new page/column: SUPRPCOL = 0
�The Report header record uses CURPOS to indicate "Show Position" as chosen from the View menu before a report is saved. Its initial value is determined by the Tools Option default setting when the report is first created.
==============================
Visual FoxPro 9-only Information Below
==============================
In non-header records, CURPOS is reserved for Report Builder use at design time. It indicates "currently-selected items", much as ASELOBJ() is used by Class and Form Builders.
CURPOS can be used by user-defined code at runtime, with the proviso that at the end of a report run the header record value should be restored and all other values should be .F.ould b �TAG2 contains printer driver information in binary in the Report header record.
For Bands, TAG2 contains On Exit run expression.
For Data-related records
For Data-related object records (OBJTYPEs 25 and 26), TAG2 holds the compiled version of event and method code written for these objects, similar to the OBJCODE field in an SCX or VCX.
==============================
Visual FoxPro 9-only Information Below
==============================
Persistence limitation: For header record (OBJTYPE 1), TAG2 is reserved for internal use. User contents will not be preserved by Report Designer sessions.
For all report control types and group control group records (OBJTYPEs 5,6,7, 8, 10, and 17), Visual FoxPro 9 reserves TAG2 for storage of tooltips.me captions. �WIDTH provides width of layout objects in FRUs.
In the report header, column width is stored here. Note that for freshly created report layouts, WIDTH contains -1. For freshly-created label layouts, WIDTH contains 0. Multi-column report and label layouts that are reset to a single column will contain the full page width (in FRUs) in the WIDTH column.
Group bands use WIDTH to provide the new page threshold:
Start group on new page when less than:[0.000]
==============================
Visual FoxPro 9-only Information Below
==============================
Detail bands use WIDTH similarly to Group bands, to provide the new page threshhold:
Start detail set on new page when less than [0.000] !In the Report Header, TAG contains printer driver info in binary.
For Bands, it contains the On Entry run expression.
For Variables, it contains Initial Value
For Data-related object records (OBJTYPEs 25 and 26), TAG holds any event and method code written for these objects.
TAG was also used for alias, order, and relation information for 20-style data environment records.
==============================
Visual FoxPro 9-only Information Below
==============================
Persistence limitation: For header record (OBJTYPE 1), TAG is reserved for internal use. User contents will not be preserved by Report Designer sessions.
TAG is reserved by Visual FoxPro 9 ReportBuilder to potentially store "Bandhint" data for various types of report controls, which can span bands. :Contains identifying information for records of OBJTYPE 25 and 26, to indicate what type of data-related class is described in the record.
For images (OBJTYPE 17), NAME is used to identify the picture in these circumstances:
* -- field option [a General field in the source table] rather than file option is chosen for this picture, OR
* -- file [an Expression] option is chosen, a valid expression is included in the NAME column, and OFFSET=2.
Note that, in the latter case, the NAME value is used in preference to Picture column value, if both exist.
For Variables (OBJTYPE 18) , NAME contains the variable name.
In 2x-style data environment workarea and index records (OBJTYPEs 2 and 3), NAME contains the filename of table or non-structural index file to be opened. For 2x-style PDSETUP records (OBJTYPE 21), NAME contains the name of the setup.
==============================
Visual FoxPro 9-only Information Below
==============================
For Expressions (OBJTYPE 8), Visual FoxPro 9 reserves NAME for storage of design-time captions.
In the Report Header, PICTURE can be used by jPICTURE contains the relative path and filename of picture for image records (OBJTYPE 17).
However, NAME is used in preference to this value in some circumstances. This usage is described in the NAME record.
This field also holds the format and inputmask values for OBJTYPE=8 (Report Expressions) and alignment formatting information for OBJTYPE=5 (Report Labels). For Report Labels, this field is empty for left justified (default), contains @I for centered or contains @J for right justified.
==============================
Visual FoxPro 9-only Information Below
==============================
RULERLINES is used only in the header record.
0 = Show Ruler Lines: No
1 = Show Ruler Lines: Yes
==============================
Visual FoxPro 9-only Information Below
==============================
RULERLINES is reserved in VFP9 for OBJTYPE=8 (Field) for StringTrimming.
Default is StringTrimmingEllipsisWord.
0 or not entered = Default
1 = StringTrimmingCharacter
2 = StringTrimmingWord
3 = StringTrimmingEllipsisCharacter
4 = StringTrimmingEllipsisWord
5 = StringTrimmingEllipsisPath (for filenames) �PICTURE contains the relative path and filename of picture for image records (OBJTYPE 17).
However, NAME is used in preference to this value in some circumstances. This usage is described in the NAME record.
This field also holds the format and inputmask values for OBJTYPE=8 (Report Expressions) and alignment formatting information for OBJTYPE=5 (Report Labels). For Report Labels, this field is empty for left justified (default), contains @I for centered or contains @J for right justified.
==============================
Visual FoxPro 9-only Information Below
==============================
In header record (OBJTYPE 1), users can store information in PICTURE to override the settings in the current printer setup when Save Printer Environment is not checked. Provide printer instructions in the name-value-pair format you see in the Expr field in the header record, for example:
COPIES=2
Information in PICTURE is added to the information in EXPR, and takes precedence over
�For the report definition (header) record, EXPR contains printer driver and print setup information.
For group headers, EXPR contains the group expression. Important note: contains nothing for group footers. If you need the group expression for a group footer, you must find the associated group header.
For Labels, EXPR contains the label caption.
For Fields, it contains the expression evaluated to provide output.
For a Report Variable, it contains the value or expression the Report Engine stores to this variable each time it moves the record pointer during a report pass.
For data environment and data object records, it contains the properties for those objects as name-value pairs; for instance, Alias = Cursor1.
EXPR is also used in 2x-style environment records. It contains the order expression when OBJTYPE=3 or the relation expression when OBJTYPE=4.
==============================
Visual FoxPro 9-only Information Below
==============================
Persistence limitation:
For header record (OBJTYPE 1), EXPR is reserved for internal use. Custom value-pairs added to this field will not be preserved by Report Designer sessions.
When "Save Printer Environment" is off, VFP 9 stores only a limited set of value-pairs to this field:
ORIENTATION=
PAPERSIZE=
PAGELENGTH= [only when specified by the current printer setup]
PAGEWIDTH= [only when specified by the current printer setup]
COLOR=
Please see the PICTURE field for additional information.
For detail bands (OBJTYPE 9, OBJCODE 4), EXPR contains the Target Alias expression.
For DE-related objects, EXPR may contain additional value-pairs in Visual FoxPro 9 to represent template DEClass and DEClasslibrary (Load Environment functionality) for these objects. nPICTURE contains the relative path and filename of picture for image records (OBJTYPE 17).
However, NAME is used in preference to this value in some circumstances. This usage is described in the NAME record.
This field also holds the format and inputmask values for OBJTYPE=8 (Report Expressions) and alignment formatting information for OBJTYPE=5 (Report Labels). For Report Labels, this field is empty for left justified (default), contains @I for centered or contains @J for right justified.
==============================
Visual FoxPro 9-only Information Below
==============================
In header record (OBJTYPE 1), users can store information in PICTURE to override the settings in the current printer setup when Save Printer Environment is not checked. Users should provide printer instructions in the name-value-pair format you see in the Expr field in the header record, for example:
COPIES=2
COLOR=1
Information in PICTURE is added to the information in EXPR, and takes precedence over EXPR when the value is re-specified. In the above example, COLOR=1 in PICTURE will take precedence over
$PICTURE contains the relative path and filename of picture for image records (OBJTYPE 17).
However, NAME is used in preference to this value in some circumstances. This usage is described in the NAME record.
This field also holds the format and inputmask values for OBJTYPE=8 (Report Expressions) and alignment formatting information for OBJTYPE=5 (Report Labels). For Report Labels, this field is empty for left justified (default), contains @I for centered or contains @J for right justified.
==============================
Visual FoxPro 9-only Information Below
==============================
In header record (OBJTYPE 1), users can store information in PICTURE to override the settings in the current printer setup when Save Printer Environment is not checked. Users should provide printer instructions in the name-value-pair format you see in the Expr field in the header record, for example:
COPIES=2
COLOR=1
YRESOLUTION=300
Information in PICTURE is added to the information in EXPR, and takes precedence over EXPR when the value is re-specified. In the above example, COLOR=1 in PICTURE will take precedence over COLOR=0 in EXPR. YRESOLUTION=300 will take precedence over the resolution specified in the current printer setup (assuming that the current printer supports 300 DPI).
�In the Report Header, TAG contains printer driver info in binary.
For Bands, it contains the On Entry run expression.
For Variables, it contains Initial Value.
For Data-related object records (OBJTYPEs 25 and 26), TAG holds any event and method code written for these objects.
TAG was also used for alias, order, and relation information for 20-style data environment records.
==============================
Visual FoxPro 9-only Information Below
==============================
Persistence limitation: For header record (OBJTYPE 1), TAG is reserved for internal use. User contents will not be preserved by Report Designer sessions.
TAG is reserved by Visual FoxPro 9 ReportBuilder to potentially store "Bandhint" data for various types of report controls, which can span bands.
In VFP 8, the product checked for information in TAG to determine whether Save Printer Environment was "on" or "off". In VFP 9, the product checks TAG2 to determine this. �TAG2 contains printer driver information in binary in the Report header record.
For Bands, TAG2 contains On Exit run expression.
For Data-related records
For Data-related object records (OBJTYPEs 25 and 26), TAG2 holds the compiled version of event and method code written for these objects, similar to the OBJCODE field in an SCX or VCX.
==============================
Visual FoxPro 9-only Information Below
==============================
Persistence limitation: For header record (OBJTYPE 1), TAG2 is reserved for internal use. User contents will not be preserved by Report Designer sessions.
For all report control types and group control group records (OBJTYPEs 5,6,7, 8, 10, and 17), Visual FoxPro 9 reserves TAG2 for storage of tooltips.
In VFP 8, the product checked for information in TAG to determine whether Save Printer Environment was "on" or "off". In VFP 9, the product checks TAG2 to determine this. �TAG2 contains printer driver information in binary in the Report header record, or is empty when Save Printer Environment is "off".
For Bands, TAG2 contains On Exit run expression.
For Data-related object records (OBJTYPEs 25 and 26), TAG2 holds the compiled version of event and method code written for these objects, similar to the OBJCODE field in an SCX or VCX.
==============================
Visual FoxPro 9-only Information Below
==============================
Persistence limitation: For header record (OBJTYPE 1), TAG2 is reserved for internal use. User contents will not be preserved by Report Designer sessions.
For all report control types and group control group records (OBJTYPEs 5,6,7, 8, 10, and 17), Visual FoxPro 9 reserves TAG2 for storage of tooltips.
In VFP 8, the product checked for information in TAG to determine whether Save Printer Environment was "on" or "off". In VFP 9, the product checks TAG2 to determine this.hecks TAG2 to determine this. xPICTURE contains the relative path and filename of picture for image records (OBJTYPE 17).
However, NAME is used in preference to this value in some circumstances. This usage is described in the NAME record.
This field also holds the format and inputmask values for OBJTYPE=8 (Report Expressions) and alignment formatting information for OBJTYPE=5 (Report Labels). For Report Labels, this field is empty for left justified (default), contains @I for centered or contains @J for right justified.
==============================
Visual FoxPro 9-only Information Below
==============================
In header record (OBJTYPE 1), users can store information in PICTURE to override the settings in the current printer setup when Save Printer Environment is not checked. Users should provide printer instructions in the name-value-pair format you see in the Expr field in the header record, for example:
COPIES=2
COLOR=1
YRESOLUTION=300
At runtime, when there is no information in the TAG2 field, the value pairs in PICTURE are added to the information in EXPR, and takes precedence over EXPR when a named attribute appears in both fields.
In the above example, COLOR=1 in PICTURE will take precedence over COLOR=0 in EXPR. YRESOLUTION=300 will take precedence over the resolution specified in the current printer setup (assuming that the current printer supports 300 DPI).
�PICTURE contains the relative path and filename of picture for image records (OBJTYPE 17).
However, NAME is used in preference to this value in some circumstances. This usage is described in the NAME record.
This field also holds the format and inputmask values for OBJTYPE=8 (Report Expressions) and alignment formatting information for OBJTYPE=5 (Report Labels). For Report Labels, this field is empty for left justified (default), contains @I for centered or contains @J for right justified.
==============================
Visual FoxPro 9-only Information Below
==============================
In header record (OBJTYPE 1), users can store information in PICTURE to override the settings in the current printer setup when Save Printer Environment is not checked. Users should provide printer instructions in the name-value-pair format you see in the Expr field in the header record, for example:
COPIES=2
COLOR=1
YRESOLUTION=300
At runtime, when there is no information in the TAG2 field, the value pairs in PICTURE are added to the information in EXPR. Values in PICTURE take precedence over EXPR when a named attribute appears in both fields.
In the above example, COLOR=1 in PICTURE will take precedence over COLOR=0 in EXPR. YRESOLUTION=300 will take precedence over the resolution specified in the current printer setup (assuming that the current printer supports 300 DPI).
For the report definition (header) record, EXPR contains printer driver and print setup information.
For group headers, EXPR contains the group expression. Important note: contains nothing for group footers. If you need the group expression for a group footer, you must find the associated group header.
For Labels, EXPR contains the label caption.
For Fields, it contains the expression evaluated to provide output.
For a Report Variable, it contains the value or expression the Report Engine stores to this variable each time it moves the record pointer during a report pass.
For data environment and data object records, it contains the properties for those objects as name-value pairs; for instance, Alias = Cursor1.
EXPR is also used in 2x-style environment records. It contains the order expression when OBJTYPE=3 or the relation expression when OBJTYPE=4.
==============================
Visual FoxPro 9-only Information Below
==============================
Persistence limitation: For header record (OBJTYPE 1), EXPR is reserved for internal use. Custom value-pairs added to this field will not be preserved by Report Designer sessions.
When "Save Printer Environment" is off, VFP 9 stores only a limited set of value-pairs to this field in the header record:
ORIENTATION=
PAPERSIZE=
PAGELENGTH= [only when specified by the current printer setup]
PAGEWIDTH= [only when specified by the current printer setup]
COLOR=
Please see the PICTURE field for additional information.
For detail bands (OBJTYPE 9, OBJCODE 4), EXPR contains the Target Alias expression.
For DE-related objects, EXPR may contain additional value-pairs in Visual FoxPro 9 to represent template DEClass and DEClasslibrary (Load Environment functionality) for these objects. �FLOAT indicates whether the object floats (relative to the size of the surrounding fields). This value is used in combination with BOTTOM and TOP.
In Object Property dialog:
Object Position:
(*) Float : FLOAT = .T.
else FLOAT = .F.
�STRETCH indicates whether the object stretches (expands vertically to display all data). This value is used in combination with STRETCHTOP.
In Object Property dialog, Stretch Downwards:
(*) No Stretch : STRETCH = .F. STRETCHTOP = .F.
(*) Stretch relative to tallest object : STRETCH = .F. STRETCHTOP = .T.
(*) Stretch relative to height of band : STRETCH = .T. STRETCHTOP = .T.
�Indicates how the object stretches relative to the top of the band. This value is used in combination with STRETCH.
In Object Property dialog, Stretch Downwards:
(*) No Stretch : STRETCH = .F. STRETCHTOP = .F.
(*) Stretch relative to tallest object : STRETCH = .F. STRETCHTOP = .T.
(*) Stretch relative to height of band : STRETCH = .T. STRETCHTOP = .T.
�STRETCH indicates how the object stretches (expands vertically to display all data). This value is used in combination with STRETCHTOP.
In Object Property dialog, Stretch Downwards:
(*) No Stretch : STRETCH = .F. STRETCHTOP = .F.
(*) Stretch relative to tallest object : STRETCH = .F. STRETCHTOP = .T.
(*) Stretch relative to height of band : STRETCH = .T. STRETCHTOP = .T.
<Contains identifying information for records of OBJTYPE 25 and 26, to indicate what type of data-related class is described in the record.
For images (OBJTYPE 17), NAME is used to identify the picture in these circumstances:
* -- field option [a General field in the source table] rather than file option is chosen for this picture, OR
* -- file [an Expression] option is chosen, a valid expression is included in the NAME column, and OFFSET=2.
Note that, in the latter case, the NAME value is used in preference to Picture column value, if both exist.
For Variables (OBJTYPE 18) , NAME contains the variable name.
In 2x-style data environment workarea and index records (OBJTYPEs 2 and 3), NAME contains the filename of table or non-structural index file to be opened. For 2x-style PDSETUP records (OBJTYPE 21), NAME contains the name of the setup.
==============================
Visual FoxPro 9-only Information Below
==============================
For Expressions (OBJTYPE 8), Visual FoxPro 9 reserves NAME for storage of design-time captions.
For images (OBJTYPE 17) an Expression used in the NAME field can include both a reference to a field, a filename, or an Image control. In the case of an image control, the current value of the control's .PictureVal property is used to provide the value. �The header record, Text-objects (OBJTYPEs 5 and 8) plus font resource records (OBJTYPE 23) use FONTFACE to store a font name.
The default font name for the report appears both in the Report header record and a separate font resource record.
Additional font resource records appear each time you add a text object to the layout using a font that does not already occur in the report. A change to any characteristic of the font (for example, style) results in a new font resource record.
For Data-related object records (OBJTYPEs 25 and 26), FONTFACE holds compiled information related to the use of #INCLUDE files in DataEnvironment code.
==============================
Visual FoxPro 9-only Information Below
==============================
Only one new font resource record is created for each font combination even if this font is used with more than one FontCharset value in the report. See DOUBLE and RESOID fields. CPICTURE contains the relative path and filename of picture for image records (OBJTYPE 17).
However, NAME is used in preference to this value in some circumstances. This usage is described in the NAME record.
This field also holds the format and inputmask values for OBJTYPE=8 (Report Expressions) and alignment formatting information for OBJTYPE=5 (Report Labels). For Report Labels, this field is empty for left justified (default), contains @I for centered or contains @J for right justified.
==============================
Visual FoxPro 9-only Information Below
==============================
In header record (OBJTYPE 1), users can store information in PICTURE to override the settings in the current printer setup when Save Printer Environment is not checked. Users should provide printer instructions in the name-value-pair format you see in the EXPR field in the header record, for example:
COPIES=3
COLOR=1
YRESOLUTION=300
At runtime, when there is no information in the TAG2 field, the value pairs in PICTURE are added to the information in EXPR. Values in PICTURE take precedence over EXPR when a named attribute appears in both fields. Values in PICTURE are case-sensitive.
In the above example, COLOR=1 in PICTURE will take precedence over COLOR=0 in EXPR. YRESOLUTION=300 will take precedence over the resolution specified in the current printer setup (assuming that the current printer supports 300 DPI).
If the PROMPT clause is used on the REPORT FORM command, the accumulated values in EXPR and PICTURE are used in addition to the base settings of SET("PRINTER",3) when the printer setup dialog is inoked. (In the above example, the default copies setting in the dialog would be 3.) From that point, any changes the user chooses to apply in the printer setup dialog take precedence during this report run.
#Specifies the font size. See notes in FONTFACE record.
The behavior of VFP's GETFONT() dialog limits the size range of available fonts to 4-127 (inclusive) when you design reports through the Report Designer interface. However, fonts outside this range display properly in reports.