---
title: "ksGetZona - Получить зону текущего чертежа по заданной точке"
type: guide
api: [api7]
domain: [drawing]
tags: [guide, api7, drawing, ksgetzona]
sources:
  - ksgetzona.html
---

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


## ksGetZona - Получить зону текущего чертежа по заданной точке

Пример...
Аналог данной функции при использовании Automation - метод ksDocument2D::ksGetZona.
Синтаксис:
```
int ksGetZona (double x,
double y,
char * zona,
int size);
Входные параметры:
x, y    - координаты точки в текущем документе.
size    - размер буфера.
Выходной параметр:
zona    - буфер для возврата зоны,
Возвращаемое значение:
1    - успешное завершение,
0    - ошибка (например, точка вне документа или документ - не чертеж),
-1    - в текущем документе нет разбиения на зоны.
Примечание.
При использовании Unicode следует использовать функцию ksGetZonaW.
```


## ksGetZona пример использования

RequestInfo info;
K ksGetZona
//обнулить структуру info;
memset (&info, 0, sizeof (info));
double x, y;
info.prompt = "Укажите точку";
char zona [128];
while (Cursor (&info, &x, &y, 0) == -1) {
int rez = ksGetZona(x, y, zona, 128); //размер присланного буфера
if (rez == -1 || !rez) {
Error(rez ? "В текущем документе нет разбиения на зоны" : "Ошибка");
break;
}
else
Message (zona);
}
