QR Get text property
QR Get text property ( area ; colNum ; rowNum ; property ) : any
| Parameter | Type | Description | |
|---|---|---|---|
| area | Integer | → | Reference of the area |
| colNum | Integer | → | Column number |
| rowNum | Integer | → | Row number |
| property | Integer | → | Property number |
| Function result | Longint, String | ← | Value for the selected property |
This command is not thread-safe, it cannot be used in preemptive code.
Description
The QR Get text property command returns the property value of the text attributes for the cell determined by colNum and RowNum.
area is the reference of the Quick Report area.
colNum is the number of the cell column.
rowNum is the reference of the cell row. You can either pass:
- a positive value designating the corresponding subtotal (break) level,
- one of the constants of the QR Rows for Properties theme:
| Constant | Type | Value | Comment |
|---|---|---|---|
| qr detail | Integer | -2 | Detail area of report |
| qr footer | Integer | -5 | Page footer |
| qr grand total | Integer | -3 | Grand total area |
| qr header | Integer | -4 | Page header |
| qr title | Integer | -1 | Title of report |
Note: When passing -4 or -5 as rowNum, you still need to pass a column number in colNum, even if it is not used.
Note: In cross-table mode, the principle is similar except for the row values, which are always positive.
property is the value of the text attribute to get. You can use the constants of the QR Text Properties theme, and the following values can be returned:
| Constant | Type | Value | Comment |
|---|---|---|---|
| _o_qr font | Integer | 1 | Obsolete since 4D v14R3 (use qr font name) |
| qr alternate background color | Integer | 9 | Alternate background color number |
| qr background color | Integer | 8 | Background color number |
| qr bold | Integer | 3 | Bold style attribute (0 or 1) |
| qr font name | Integer | 10 | Name of font as returned for example by the FONT LIST command |
| qr font size | Integer | 2 | Font size expressed in points (9 to 255) |
| qr italic | Integer | 4 | Italic style attribute (0 or 1) |
| qr justification | Integer | 7 | Justification attribute (0 for default, 1 for left, 2 for center or 3 for right) |
| qr text color | Integer | 6 | Color number attribute (Longint) |
| qr underline | Integer | 5 | Underline style attribute (0 or 1) |
If you pass an invalid area number, the error -9850 will be generated.
If you pass an invalid colNum number, the error -9852 will be generated.
If you pass an invalid rowNum number, the error -9853 will be generated.
If you pass an invalid property number, the error -9854 will be generated.