---
title: "TextLine - Задать подстроку параграфа текста"
type: guide
api: [api7]
tags: [guide, api7, textline]
sources:
  - textline.html
---

*API экспортных функций > Функции работы с графическим документом  > Простановка текстовых надписей  > Функции работы с текстовыми надписями и таблицами *

Пример...
Аналог данной функции при использовании Automation - метод ksDocument2D::ksTextLine.
Синтаксис:
```
int TextLine (unsigned int bitVector, int type, void *value, char * s);
Входной параметр:
bitVector    - значения свойств, устанавливаемые двоичными флагами,
type    - тип свойства.
Выходной параметр:
value    - указатель на значение свойства,
s    - создаваемый компонент текста.
Возвращаемое значение:
1    - в случае успешного завершения,
0    - в случае неудачи.
```
Примечание:
1. Функция предназначена для задания сложноструктурированного текста, отдельные компоненты которого имеют различные параметры.
2. Спецзнак задается отдельной компонентой. Таблица спецсимволов размещена в файле SDK\NumbSymb.frw.
3. Не рекомендуется использовать в строке символы, которые могут идентифицироваться как управляющие символы: @ $ & ; ~ ^ # кроме случаев, когда эти символы используются в строке именно как управляющие."
4. Использование управляющих символов:
– отклонение: $ верхнее отклонение ; нижнее отклонение $
– дробь: $d числитель ; знаменатель $
– спецсимвол: &nnn номер спецсимвола
5. bitVector формируется с помощью логической операции | из набора определений [INVARIABLE ...NEW_LINE] (см. ltdefine.h).
6. При использовании Unicode следует использовать функцию TextLineW.
