---
title: "ksAnnTextEx - Создать многострочный текст по структуре параметров с аннотационной точкой привязки"
type: guide
api: [api7]
tags: [guide, api7, ksanntextex]
sources:
  - ksanntextex.html
---

*API экспортных функций > Функции работы с графическим документом  > Создание графических объектов  > Аннотационные объекты *

Аналог данной функции при использовании Automation - метод ksDocument2D::ksAnnTextEx.
Синтаксис:
```
reference ksAnnTextEx( TextParam * txtParam,
int align );
Входные параметры:
txtParam    - параметры текста,
align    - выравнивание текста: -1 - установить выравнивание как у стиля текста, 0 - слева, 1 - по центру, 2 - справа, 3 - на всю ширину.
Возвращаемое значение:
указатель на текст    - в случае удачного завершения,
0    - в случае неудачи.
```
Примечание:
1. Аннотационные объекты можно создавать только в составе макро. Допускается создание аннотационных объектов во временной группе для последующего добавления в макро.
2. При разрушении макро-аннотационные объекты превращаются в геометрические.
3. Координаты точки привязки не зависят от масштаба вида.