# Elementname: `Textblock`

## Description

Create a rectangular piece of text.

Allowed attributes: angle, color, columndistance, columns, fontface, minheight, textformat, width

Child elements: Action, Bookmark, Copy-of, ForAll, Loop, Ol, Paragraph, Switch, Ul, Value

Parent elements: Frame, Overlay, PlaceObject, Position, Transformation

### Attributes

angle (number, optional)

  The angle (counter clockwise) that the text gets turned.

color (text, optional)

  The name of the color of the text.

columndistance (number or length, optional)

  Distance between two columns. Defaults to 3mm.

columns (number, optional)

  Number of columns in the textblock. Do not use multi columns for any other purposes than simple text.

fontface (text, optional)

  The name of the font family. Defaults to `text`.

minheight (number or length, optional, since version 2.3.28)

  The minimum height of the textblock, given as a length or number (grid cells).

textformat (text, optional)

  The name of the text format to be applied to the text. Defaults to `text`.

width (number, optional)

  Number of columns for the text. If not given, the surrounding element determines the width of the element.

### Remarks

The textformat change the appearance of the paragraphs. They have to be previously defined by DefineTextformat.

Be careful when using multi column typesetting. This will only work with simple text, not with lists or so.

## Example

    <Record element="data">
      <PlaceObject>
        <Textblock width="10" angle="-20">
          <Paragraph>
            <B><Value>Bold slanted text</Value></B>
          </Paragraph>
        </Textblock>
      </PlaceObject>
    </Record>

## See also

DefineTextformat, DefineColor, Paragraph, PlaceObject

# Commands

- A
- Action
- AddSearchpath
- AtPageCreation
- AtPageShipout
- AttachFile
- Attribute
- B
- Barcode
- Bold
- BoldItalic
- Bookmark
- Box
- Br
- Case
- Circle
- Color
- Column
- Columns
- Compatibility
- Contents
- Copy-of
- DefineColor
- DefineColorprofile
- DefineFontalias
- DefineFontfamily
- DefineTextformat
- Element
- Fallback
- Fontface
- ForAll
- Frame
- Grid
- Group
- Groupcontents
- HSpace
- Hyphenation
- I
- Image
- Include
- Initial
- InsertPages
- Italic
- Layout
- Li
- LoadDataset
- LoadFontfile
- Loop
- Makeindex
- Margin
- Mark
- Message
- NewPage
- NextFrame
- NextRow
- NoBreak
- Ol
- Options
- Otherwise
- Output
- Overlay
- PDFOptions
- Pageformat
- Pagetype
- Paragraph
- PlaceObject
- Position
- PositioningArea
- PositioningFrame
- ProcessNode
- Record
- Regular
- Rule
- SaveDataset
- SavePages
- SetGrid
- SetVariable
- SortSequence
- Span
- Stylesheet
- Sub
- Sup
- Switch
- Table
- TableNewPage
- Tablefoot
- Tablehead
- Tablerule
- Td
- Text
- Textblock
- Tr
- Trace
- Transformation
- U
- URL
- Ul
- Until
- VSpace
- Value
- While

Version: 3.8.0 | Start page | Command reference | Other language: German