QR SET TEXT PROPERTY

4D - Documentation   Français   English   German   4th Dimension 2004, Command Theme List   4th Dimension 2004, Command Alphabetical List   4th Dimension 2004, Constant Theme List   Back   Previous   Next

version 2003


QR SET TEXT PROPERTY (area; colNum; rowNum; property; value)

ParameterTypeDescription
areaLongintReference of the area
colNumLongintColumn number
rowNumLongintRow number
propertyLongintOperator value for the cell
valueLongintValue for the selected property

Description

The QR SET TEXT PROPERTY command allows you to set 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:

if rowNum equals -1, it designates the column title.

if rowNum equals -2, it designates the detail area.

if rowNum equals -3, it designates the column grand total.

if rowNum equals -4, it designates the page header.

if rowNum equals -5, it designates the page footer.

You can use constants from the QR Rows for Properties theme to designate the row item. Constant Values are: qr title (-1), qr detail (-2), qr grand total (–3), qr header (–4), and qr footer (-5).

Note: When passing -4 or -5 as rowNum, you still need to pass a column number in colNum, even if it is not used.

if rowNum is a positive value, it designates the corresponding subtotal (break level).

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 assign. You can use the constants of the QR Text Properties theme, and the following values can be set:

Constant (value)Value to set
qr font (1)font number as returned through FONT LIST
qr font size (2)font size expressed in points (9 to 255)
qr bold (3)Bold style attribute (0 or 1)
qr italic (4)Italic style attribute (0 or 1)
qr underline (5)font Underline style attribute (0 or 1)
qr text color (6)font Color number attribute (longint)
qr justification (7)font Justification attribute (0 for default, 1 for left, 2 for center
or 3 for right)
qr background color (8)background color number
qr alternate background color (9)alternate background color number

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.

Example

This method defines several attributes of the first column's title:

      `The following call assigns the font Times:
   QR SET TEXT PROPERTY(qr_area;1;-1;qr font;Font number("Times"))
      `assigning the font size 10 points:
   QR SET TEXT PROPERTY(qr_area;1;-1;qr font size;10)
      `assigning the font attribute Bold:
   QR SET TEXT PROPERTY(qr_area;1;-1;qr bold;1)
      `assigning the font attribute Italic:
   QR SET TEXT PROPERTY(qr_area;1;-1;qr italic;1)
      `assigning the font attribute Underline:
   QR SET TEXT PROPERTY(qr_area;1;-1;qr underline;1)
      `assigning the color bright green:
   QR SET TEXT PROPERTY(qr_area;1;-1;qr text color;0x0000FF00)

See Also

QR Get text property.


4D - Documentation   Français   English   German   4th Dimension 2004, Command Theme List   4th Dimension 2004, Command Alphabetical List   4th Dimension 2004, Constant Theme List   Back   Previous   Next