# Texts, Labels

In the combo element, single-line and (24.01.4) multi-line texts and labels can be created. For the label, the reference point for the connecting line to the label can also be set in relation to the text position.

* The texts and labels can be located in the current structural element as well as in other structural elements. For example, when inserting into a wall, a dimension can be created in the storey (floor plan).
* The text can consist of direct entries and variables. See chapter “Variables in Texts, Identification Numbers”.

The alignment of the texts and labels, the position, and the reference points depend on the different coordinate systems:

* The alignment is oriented to the insertion coordinate system when inserted into the base structural element; otherwise, it is oriented to the projected insertion coordinate system. For details, see chapter: Shift and projections of insertion coordinate systems.
* The alignment is generally parallel to the X-axis, and the specified rotation angle is rotated mathematically positively (counterclockwise).
* The points for position and reference are defined in the insertion coordinate system. They are then projected perpendicularly onto the drawing plane. This is the drawing plane of the structural element into which the text or label is to be inserted.
* Because the points are projected, one coordinate is automatically 0. Therefore, this coordinate is partially locked already in the input.

When a text or a label is created, it is automatically assigned a number: 1, 2, etc.

* The number is displayed on the left in the tree element of the composite element.
* A description can be entered at the lower right of the auxiliary image. This serves for documentation. The first part of the description is also displayed on the left in the tree element of the combo element. This makes it much faster to identify the text or label in the tree element.

Text style: The text style for the text or label.

* Here, the name of a text style can be selected. The text styles stored in the settings are displayed, not those of the current building.
* Only the name of the text style is saved.
* If the combo element is inserted into a building, and a text style with this name exists in the building, its settings are used.
  * If the text style does not yet exist in the building, it is searched for in the saved settings and, if necessary, copied into the building.
  * If the text style is not found in the saved settings either, the text or label is not created and a corresponding message is displayed.

Layer: The layer to which the text or label is to be assigned.

* Here, the name of a layer can be selected. In both the drop list and the layer dialog box, which is opened via the browser button, the layers of the current structure are displayed.
* Only the name of the layer is saved.
* If the composite element is inserted into a structure, a layer with this name is searched for in the structure. If the layer is present in the structure, its settings are used.
  * If the layer is not yet present in the structure, it is created with default values: line type = solid, line weight = standard line weight from 'DICAM 1-7-2 Screen Elements Settings', color set = black, scale = 1:50.
* To display the text height correctly, a scale is required. This is stored in the building on the layer. The text height is then displayed in the correct size ratio to the other elements of the representation.
  * If, when inserting the combo element, the layer for the text or label has a scale of 1:1, the text would be very difficult to read. Therefore, a dialog automatically appears in which either another layer can be selected or the scale of the layer can be changed.

Text: The text can consist of direct entries and variables. See chapter “Variables in Texts, Identification Numbers”.

Text type: A choice is made here between single-line text and single-line label.

* For the single-line label, the inputs for the reference point become active.

Text at insertion point: Specifies whether the text should be left-aligned or right-aligned relative to the insertion point.

'insert in composite element' and conditions:

* Here, the conditions under which the text or label is to be created can be defined. Further information can be found in the chapter “Conditions”.

Insert into: The text or label is created in the specified structural element.

* Only building elements that are available at that moment can be used.

Rotation angle:

* The alignment is oriented to the insertion coordinate system when inserted into the base structural element; otherwise, it is oriented to the projected insertion coordinate system. For details, see chapter: Shift and projections of insertion coordinate systems.
* The alignment is generally parallel to the X-axis, and the specified rotation angle is rotated mathematically positively (counterclockwise).

Text insertion point, X, Y, Z offset: The coordinates of the point at which the text is to be placed are specified here:

* When specifying point coordinates, the coordinate systems must be observed; see the description at the beginning of this chapter. Due to the structural element for the text, the insignificant coordinate is locked; it is automatically set to 0.
* For example, if a combo element is inserted into the wall and a text is created in the storey, a negative Y offset moves the text away from the wall.
* If the text is subsequently moved manually in the building, this changed position is written into the inserted combo element. In a recalculation, the changed position is therefore retained.

Label reference point, X, Y, Z offset: The coordinates of the reference point at which the label is to be attached are specified here:

* When specifying point coordinates, the coordinate systems must be observed; see the description at the beginning of this chapter. Due to the structural element for the text, the insignificant coordinate is locked; it is automatically set to 0.

In combo elements, multi-line texts and labels (multiline) with tab stops can now also be defined. For this purpose, corresponding characters are inserted into the text definition.

* For a line break, “¶” is inserted. Input Alt+0182.
  * Example: **Text line 1¶Text line 2** results after execution of the combo element:\
    **Text line 1**\
    **Text line 2**
* For a tab stop, “¬” is inserted: Input Alt+0172.
  * If a table is defined in the text style, the tab stop jumps to the next column.
  * Example: **Cell 1.1¬Cell 1.2¶Cell 2.1¬Cell 2.2** results after execution of the combo element:\
    **Cell 1.1 Cell 1.2**\
    **Cell 2.1 Cell 2.2**
* These characters can be entered directly in the definition of the text entry. However, it is also possible to use them in intermediate values and then use the intermediate value in the text entry.
* These characters can be combined with fixed text and with variables or intermediate values.

  With multi-line texts, it is now very easy to describe contiguous blocks of text. Previously, the single-line texts had to be aligned accordingly. Now the line height is taken directly from the text style. In addition, tables can now also be generated.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dietrichs.com/dietrichs-intelligent-documentation/docs-de-en/combined-elements/create-edit-combined-elements/texts-labels.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
