---
title: "TextW - Создать строку текста в графическом документе (Unicode)"
type: guide
api: [api7]
tags: [guide, api7, textw]
sources:
  - textw.html
---

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

Аналог данной функции при использовании Automation - метод ksDocument2D::ksText.
Синтаксис:
```
reference TextW (double x,
double y,
double ang,
double hStr,
double ksuStr,
unsigned int bitVector,
LPWSTR s);
Входные параметры:
x, y    - координаты точки привязки текста,
ang    - угол наклона текста,
hStr    - высота символов,
ksuStr    - сужение текста,
bitVector    - битовый вектор, задающий признаки начертания текста,
s    - строка символов.
Признаки начертания текста...
Возвращаемое значение:
указатель на текст    - в случае удачного завершения,
0    - в случае неудачи.
```
Примечание:
1. Строка символов может включать спецсимвол. Например, чтобы задать 10 градусов, необходимо указать значение "10&01". Таблица спецсимволов размещена в файле SDK\NumbSymb.frw.
2. Не рекомендуется использовать в строке символы, которые могут идентифицироваться как управляющие символы: @ $ & ; ~ ^ #, кроме случаев, когда эти символы используются в строке именно как управляющие."
3. Использование управляющих символов:
– отклонение: $ верхнее отклонение ; нижнее отклонение $
– дробь: $d числитель ; знаменатель $
– спецсимвол: &nn номер спецсимвола 0...99.
4. bitVector формируется с помощью логической операции |. Поддерживаются определения:
– ITALIC_ON ( включить наклон ),
– BOLD_ON (включить утолщение),
– UNDERLINE_ON (включить подчеркивание). См. ltdefine.h.
5. При использовании ANSI следует использовать функцию Text.
6. При использовании внутри таблицы функция TextW не возвращает указатель на текст — в случае успешного завершения возвращается 1.
