Parameters for Text Handling

Before ARCHICAD 22, selected Text Style controls were available for annotation tools (therefore library parts) spread on various settings dialog panels. Starting from ARCHICAD 22, a standard set of text handling controls became part of every annotation dialog in form of a dedicated “Text Style” panel.

Library parts belonging to such tools have access to these functions by using the following fix named optional parameters.

Starting from ARCHICAD 22, the locking/hiding of the corresponding ARCHICAD interface controls (if exist) is an option by using LOCK and HIDEPARAMETER commands via the parameter script of the library part, combined with “Enable hide/lock of specific fix named optional parameters” setting (see “Details/Compatibility Options” dialog of the object in the Library Part Editor).

For tool/version history, refer to the compatibility notes of each parameter.

By default, the following parameters are considered available and compatible before ARCHICAD 22, while exceptions are mentioned separately.

AC_TextFont_1 string
Name of the currently selected/stored Font Type.
Compatibility: introduced in ARCHICAD 22 for Label objects. The similar global variable “LABEL_FONT_NAME” is considered deprecated since.
AC_TextSize_1 real
Currently set/stored Font Size value in mm.
Compatibility: introduced in ARCHICAD 22 for Label and Zone objects. The similar global variable “LABEL_TEXT_SIZE” is considered deprecated in Labels. In Zone objects, the “ROOM_LSIZE” fix named optional parameter is also considered deprecated since.
AC_TextStyle_1 integer
Font Style value mask. Can be used as direct input parameter for DEFINE STYLE{2} or UI_TEXTSTYLE_INFIELD.
values:
values = j1 + 2*j2 + 4*j3 + 128*j8, where each j can be 0 or 1.
j1: bold,
j2: italic,
j3: underline,
j4: strikethrough.
If AC_TextStyle_1 = 0, then style is normal.
Compatibility: introduced in ARCHICAD 22 for Zone and Label objects. The similar global variable “LABEL_FONT_STYLE2” is considered deprecated in Labels.
AC_TextPen_1 integer
Index of the currently selected/stored Text Pen.
Compatibility: introduced in ARCHICAD 22 for Zone and Label objects. The similar global variable “LABEL_TEXT_PEN” is considered deprecated since in Labels.

 
The following set of text handling parameters are available for all annotation-type library parts. In Labels, the corresponding global variables are considered deprecated. See Deprecated Label Globals section for the full list of out-of-date label globals.

AC_TextAlignment_1 integer
Alignment of the text.
1 – left aligned, 2 – center aligned, 3 – right aligned, 4 – full justified
Compatibility: introduced in ARCHICAD 22. In Labels, the similar global variable “LABEL_TEXT_ALIGN” is considered deprecated since ARCHICAD 22.
AC_TextLeading_1 real
Line spacing factor of the text.
Compatibility: introduced in ARCHICAD 22. In Labels, the similar global variable “LABEL_TEXT_LEADING” is considered deprecated since ARCHICAD 22.
AC_TextCharWidthFactor_1 real
Character width factor of the text.
Compatibility: introduced in ARCHICAD 22. In Labels, the similar global variable “LABEL_TEXT_WIDTH_FACT” is considered deprecated since ARCHICAD 22.
AC_TextCharSpaceFactor_1 real
Character spacing factor of the text.
Compatibility: introduced in ARCHICAD 22. In Labels, the similar global variable “LABEL_TEXT_CHARSPACE_FACT” is considered deprecated since ARCHICAD 22.