---
title: "ksSetTableColumnText - Задать текст ячейки таблицы"
type: guide
api: [api7]
tags: [guide, api7, kssettablecolumntext]
sources:
  - kssettablecolumntext.html
---

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


## ksSetTableColumnText - Задать текст ячейки таблицы

Пример...
Аналог данной функции при использовании Automation - метод ksDocument2D::ksSetTableColumnText.
Синтаксис:
```
int ksSetTableColumnText (unsigned int numb, TextParam *par);
Входные параметры:
numb    - номер ячейки,
Выходные параметры:
par    - указатель на структуру параметров строки текста TextParam.
Возвращаемое значение:
1    - в случае успешного завершения,
0    - в случае неудачи.
```
Примечание:
Функция используется в режиме редактирования таблицы:
ksOpenTable ();
ksSetTableColumnText ();
EndObj ();


## ksSetTableColumnText - Пример использования

// редактирование таблицы
reference pObj;
RequestInfo info;
double x, y;
memset(&info, 0, sizeof(info));
info.prompt = "Укажите таблицу";
// взять таблицу на чертеже
int j = Cursor(&info, &x ,&y, 0);
if (j)
{
if (ExistObj (pObj = FindObj (x, y, 100000)))
{
//узнаем тип объекта
int type =GetObjParam (pObj,0,0,0); //указатель на графический объект
//проверить, таблица ли полученный объект
if (type == TABLE_OBJ)
{
unsigned int numb;
reference p;
//открыть таблицу для редактирования
ksOpenTable (pObj);
TextParam par;
//в цикле будем брать все существующие ячейки
while ((ksGetTableColumnText (&numb, &par))!=0)
{
p=par.pTextLine;
TextLineParam linePar;
for (int i=0; i < GetArrayCount(p); i)
{
GetArrayItem(p , i, &linePar, sizeof(TextLineParam));
TextItemParam itemPar;
for (int j=0; j< GetArrayCount(linePar.pTextItem); j)
{
GetArrayItem (linePar.pTextItem, j, &itemPar,
sizeof (TextItemParam));
if (strlen(itemPar.s))
{
strcat(itemPar.s, "!!!");
SetArrayItem (linePar.pTextItem, j, &itemPar,
sizeof(TextItemParam));
}
}
SetArrayItem(p , i, &linePar, sizeof(TextLineParam));
}
//очистим массив текстовых строк
ksSetTableColumnText(numb, &par);
}
EndObj();//закрыли объект "таблица"
}
else
Error("Указанный объект - не таблица");
}
else
Error("нет объекта");
}
