Интерфейс Regions

Объект Regions предназначен для создания регионов. Подробнее...

Полный список членов класса

Открытые члены

 CombineRgn ([in] ULONG hrgnSrc1,[in] ULONG hrgnSrc2,[in] LONG fnCombineMode,[out, retval] IDispatch **pRegion)
 Метод создает новый регион на основе двух существующих.
 CreateEllipticRgn ([in] LONG Left,[in] LONG Top,[in] LONG Width,[in] LONG Height,[out, retval] IDispatch **pRegion)
 Метод создает эллиптический регион.
 CreatePolygonRgn ([in] SAFEARRAY(VARIANT) Data,[out, retval] IDispatch **pRegion)
 Метод создает регион - многоугольник.
 CreateRectRgn ([in] LONG Left,[in] LONG Top,[in] LONG Width,[in] LONG Height,[out, retval] IDispatch **pRegion)
 Метод создает прямоугольный регион.
 CreateRoundRectRgn ([in] LONG Left,[in] LONG Top,[in] LONG Width,[in] LONG Height,[in] LONG nWidthEllipse,[in] LONG nHeightEllipse,[out, retval] IDispatch **pRegion)
 Метод создает прямоугольный регион с закругленными краями.
 TransformRgn ([in] ULONG ARegion,[in] FLOAT eM11,[in] FLOAT eM12,[in] FLOAT eM21,[in] FLOAT eM22,[in] FLOAT eDx,[in] FLOAT eDy,[out, retval] IDispatch **pRegion)
 Метод создает новый регион путем преобразования существующего, c помощью этого метода можно например создать растянутый или повернутый регион.
 EqualRgn ([in] ULONG hSrcRgn1,[in] ULONG hSrcRgn2,[out, retval] VARIANT_BOOL *pResult)
 Метод позволяет определить, равны ли два региона.
 CreateRgnFromImage ([in] VARIANT Image,[in] ULONG MaskColor,[out, retval] IDispatch **Region)
 Метод создает регион на основании изображения.

Подробное описание

Объект Regions предназначен для создания регионов.

Регионы могут использоваться для задания фигуры формы, или рисования сложных фигур.

Методы

CombineRgn ( [in] ULONG  hrgnSrc1,
[in] ULONG  hrgnSrc2,
[in] LONG  fnCombineMode,
[out, retval] IDispatch **  pRegion 
)

Метод создает новый регион на основе двух существующих.

Аргументы:
hrgnSrc1 первый регион
hrgnSrc2 второй регион
fnCombineMode режим создания нового региона, может принимать одно из значений:
  • RGN_AND создается пересечение обоих регионов
  • RGN_OR создается объединение обоих регионов
  • RGN_XOR создается объединение обоих регионов без их общей части
  • RGN_DIFF создается регион содержащий область первого региона за вычетом области второго региона
  • RGN_COPY создается копия первого региона
Возвращаемые значения:
pRegion Создаваемый регион в виде объекта Region

CreateEllipticRgn ( [in] LONG  Left,
[in] LONG  Top,
[in] LONG  Width,
[in] LONG  Height,
[out, retval] IDispatch **  pRegion 
)

Метод создает эллиптический регион.

Аргументы:
Left отступ слева
Top отступ сверху
Width длина эллипса
Height высота эллипса
Возвращаемые значения:
pRegion Создаваемый регион в виде объекта Region

CreatePolygonRgn ( [in] SAFEARRAY(VARIANT)  Data,
[out, retval] IDispatch **  pRegion 
)

Метод создает регион - многоугольник.

Аргументы:
Data массив координат, должны поочередно перечисляться x и y координаты (x1,y1,x2,y2,...), метод имеет переменное число параметров, в числе параметров могут быть как числа так и массивы SAFEARRAY(VARIANT).
Возвращаемые значения:
pRegion Создаваемый регион в виде объекта Region

CreateRectRgn ( [in] LONG  Left,
[in] LONG  Top,
[in] LONG  Width,
[in] LONG  Height,
[out, retval] IDispatch **  pRegion 
)

Метод создает прямоугольный регион.

Аргументы:
Left отступ слева
Top отступ сверху
Width длина эллипса
Height высота эллипса
Возвращаемые значения:
pRegion Создаваемый регион в виде объекта Region

CreateRgnFromImage ( [in] VARIANT  Image,
[in] ULONG  MaskColor,
[out, retval] IDispatch **  Region 
)

Метод создает регион на основании изображения.

Аргументы:
Image изображение.
MaskColor цвет маски, все точки с заданным цветом исключаются из региона.
Возвращаемые значения:
Region Создаваемый регион в виде объекта Region
Начиная с:
1.1.6.

CreateRoundRectRgn ( [in] LONG  Left,
[in] LONG  Top,
[in] LONG  Width,
[in] LONG  Height,
[in] LONG  nWidthEllipse,
[in] LONG  nHeightEllipse,
[out, retval] IDispatch **  pRegion 
)

Метод создает прямоугольный регион с закругленными краями.

Аргументы:
Left отступ слева
Top отступ сверху
Width длина эллипса
Height высота эллипса
nWidthEllipse длина горизонтальной полуоси эллипсов, скругляющих углы прямоугольника
nHeightEllipse длина вертикальной полуоси эллипсов, скругляющих углы прямоугольника
Возвращаемые значения:
pRegion Создаваемый регион в виде объекта Region

EqualRgn ( [in] ULONG  hSrcRgn1,
[in] ULONG  hSrcRgn2,
[out, retval] VARIANT_BOOL *  pResult 
)

Метод позволяет определить, равны ли два региона.

Аргументы:
hSrcRgn1 первый регион
hSrcRgn2 второй регион
Возвращаемые значения:
pResult логическое значение, "TRUE" если регионы равны.

TransformRgn ( [in] ULONG  ARegion,
[in] FLOAT  eM11,
[in] FLOAT  eM12,
[in] FLOAT  eM21,
[in] FLOAT  eM22,
[in] FLOAT  eDx,
[in] FLOAT  eDy,
[out, retval] IDispatch **  pRegion 
)

Метод создает новый регион путем преобразования существующего, c помощью этого метода можно например создать растянутый или повернутый регион.

Аргументы:
ARegion регион, на основе которого создается новый регион, существующий регион не изменяется
eM11,eM12,eM21,eM22,eDx,eDy задают матрицу преобразования. Пребразованные координаты X, Y определяются через старые координаты x, y по формулам:
X = x * eM11 + y * eM21 + eDx,
Y = x * eM12 + y * eM22 + eDy,
матрица пребразования имеет вид
| eM11 eM12 0 |
| eM21 eM22 0 |
| eDx eDy 1 |
Возвращаемые значения:
pRegion Создаваемый регион в виде объекта Region

Документация по WSO 1.1. Последние изменения:Wed Aug 12 18:11:13 2015. (C) Веретенников А. Б. 2004-2015