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

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


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

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


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

double x = 0; double y = 0;
// Указать точку в замкнутой области
if ( Cursor( NULL, &x, &y, NULL ) ) {
// Создать контур из объектов окружающих данную точку
reference group = ksMakeEncloseContours( 0, x, y );
if ( group ) {
// Создать заливку для группы
ksColouringEx( RGB(255, 0, 0), group );
// Удалить временную группу
DeleteObj( group );
}
}