Методы отсечения.

CDC:: ExcludeClipRect

Этот метод создает новую область отсечения, которая состоит из существующей области отсечения минус указанный прямоугольник.

int ExcludeClipRect (

int x1,

int y1,

int x2,

int y2);

virtual int ExcludeClipRect (

LPCRECT lpRect);

Параметры

x1 - x-координата левого верхнего угла прямоугольника.

y1 - y-координата левого верхнего угла прямоугольника.

x2 - x-координата нижнего правого угла прямоугольника.

y2 - y-координата нижнего правого угла прямоугольника.

lpRect - прямоугольник, также может быть объект CRect.

Возвращаемое значение - тип новой области отсечения. Это может быть любое из следующих значений:

• COMPLEXREGION - область имеет накладывающиеся границы.

• ОШИБКА - никакая область не была создана.

• NULLREGION - область пуста.

• SIMPLEREGION - область не имеет никаких границ перекрывания.

CDC:: ExcludeUpdateRgn

Этот метод запрещает рисование в пределах недопустимых областей окна исключением модифицированной области из области отсечения, связанной с объектом CDC.

int ExcludeUpdateRgn (

CWnd* pWnd );

Параметры

pWnd - указатель на окно объекта, которое будет модифицироваться.

Возвращаемое значение - тип исключенной области. Это может быть любое из следующих значений:

• COMPLEXREGION - Область имеет накладывающиеся границы.

• ОШИБКА - Никакая область не была создана.

• NULLREGION - Область пуста.

• SIMPLEREGION - Область не имеет никаких границ перекрывания.

CDC:: GetClipBox

Этот метод возвращает измерения самого плотно ограниченного прямоугольника вокруг границы отсечения. Измерения скопированы в буфер, на который указывает lpRect.

virtual int GetClipBox (

LPRECT lpRect )

const;

Параметры

lpRect - указатель на структуру RECT или объект CRect, который должен получить измерения прямоугольника.

Возвращаемое значение - Тип области отсечения. Это может быть любое из следующих значений:

• COMPLEXREGION - Область имеет накладывающиеся границы.

• ОШИБКА - Никакая область не была создана.

• NULLREGION - Область пуста.

• SIMPLEREGION - Область не имеет никаких границ перекрывания.

CDC:: IntersectClipRect

Этот метод создает новую область отсечения, формируя пересечение текущей области и прямоугольника, указанного x1, y1, x2, и y2.

int IntersectClipRect (

int x1 ,

int y1 ,

int x2 ,

int y2 );

int IntersectClipRect (

LPCRECT lpRect );

Параметры

x1 - x-координата левого верхнего угла прямоугольника.

y1 - y-координата левого верхнего угла прямоугольника.

x2 - x-координата нижнего правого угла прямоугольника.

y2 - y-координата нижнего правого угла прямоугольника.

lpRect - прямоугольник, также может быть объект CRect или структура LPRECT.

Возвращаемое значение - тип новой области отсечения. Это может быть любое из следующих значений:

• COMPLEXREGION - область имеет накладывающиеся границы.

• ОШИБКА - никакая область не была создана.

• NULLREGION - область пуста.

• SIMPLEREGION - область не имеет никаких границ перекрывания.

CDC:: OffsetClipRgn

Этот метод перемещает область отсечения контекста устройства c указанными смещениями. Метод перемещает область на x единиц по оси X и y единиц по оси Y.

int OffsetClipRgn (

int x,

int y);

int OffsetClipRgn (

SIZE size);

Параметры

x – количество логических единиц для сдвига влево и вправо;

y - количество логических единиц для сдвига вверх и вниз.

Size - величина смещения.

Возвращаемое значение - тип новой области отсечения. Это может быть любое из следующих значений:

• COMPLEXREGION - область имеет накладывающиеся границы.

• ОШИБКА - никакая область не была создана.

• NULLREGION - область пуста.

• SIMPLEREGION - область не имеет никаких границ перекрывания.

CDC:: RectVisible

Этот метод определяет, находится ли любая часть указанного прямоугольника в пределах области отсечения контекста экрана.

virtual BOOL RectVisible (

LPCRECT lpRect )

const;

Параметры

lpRect - указатель на структуру RECT или объект CRect, который содержит логические координаты указанного прямоугольника.

Возвращаемое значение - отлично от нуля, если любая часть данного прямоугольника находится в пределах области отсечения; иначе - нулевое