---
title: "ksColouring - Создать фоновую заливку цветом"
type: guide
api: [api7]
tags: [guide, api7, kscolouring]
sources:
  - kscolouring.html
---

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


## ksColouring - Создать фоновую заливку цветом

Пример...
Аналог данной функции при использовании Automation - метод ksDocument2D::ksColouring.
Синтаксис:
```
int ksColouring (unsigned long color);
Входной параметр:
color    - цвет заливки.
Возвращаемое значение:
1    - в случае успешного завершения,
0    - в случае неудачи.
```
Примечание:
1. Заливка - составной объект. Объекты вида, вводимые между операторами ksColouring и EndObj, принадлежат заливке и образуют ее границу. EndObj возвращает указатель на заливку.
2. Если color = -1 или 0xFFFFFFFF - создается заливка цветом фона документа.


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

//заливка цветом
Mtr(30,20,0,0.5);
char buf [128];
//построить заштрихованный квадрат
LineSeg (20, 30, 70, 30, 2);
LineSeg (70, 30, 70, 80, 2);
LineSeg (70, 80, 20, 80, 2);
LineSeg (20, 80, 20, 30, 2);
// залить квадрат цветом
if(ksColouring(RGB(168,0,168))) {
LineSeg (20, 30, 70, 30, 2);
LineSeg (70, 30, 70, 80, 2);
LineSeg (70, 80, 20, 80, 2);
LineSeg (20, 80, 20, 30, 2);
reference p = EndObj();
//взять параметры заливки - цвет
unsigned long col;
int t = GetObjParam(p, &col, sizeof(col), ALLPARAM);
sprintf(buf, " t = %d, color=%d ", t, col);
Message(buf);
DeleteMtr();
Mtr(0,0,0,2);
col = RGB(0, 255, 255);
//изменить параметры заливки - цвет
if(SetObjParam(p, &col, sizeof(col), ALLPARAM))
Message(" Изменили объект");
else
MessageBoxResult();
DeleteMtr();
}
else
MessageBoxResult();