Функция SubtractRect

Функция SubtractRect определяет координаты прямоугольника, сформированного вычитанием одного прямоугольник из другого.

Синтаксис

BOOL SubtractRect(
  LPRECT lprcDst,        // целевой прямоугольник
  CONST RECT *lprcSrc1,  // первый прямоугольник
  CONST RECT *lprcSrc2   // второй прямоугольник
);

Параметры

lprcDst

[out] Указатель на структуру RECT, которая получает координаты прямоугольника, определенного вычитанием прямоугольника, указанного при помощи параметра lprcSrc2 из прямоугольника, указанного при помощи параметра lprcSrc1.

lprcSrc1

[in] Указатель на структуру RECT, из которой функция вычитает прямоугольник, указанный при помощи параметра lprcSrc2.

lprcSrc2

[in] Указатель на структуру RECT, которую функция вычитает из прямоугольника, указанного при помощи параметра lprcSrc1.

Возвращаемые значения

Если функция завершается успешно, возвращаемое значение - не нуль.

Если функция завершается ошибкой, возвращаемое значение - нуль.

Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Замечания

Функция только вычитает прямоугольник, указанный lprcSrc2 из прямоугольника, указанного lprcSrc1 тогда, когда прямоугольники пересекаются полностью или по x-или по y- осям. Например, если у *lprcSrc1 имеет координаты (10, 10, 100, 100), а *lprcSrc2, имеет координаты (50, 50, 150, 150), то функция устанавливает координаты прямоугольника, указанного при помощи lprcDst в (10, 10, 100, 100). Если у *lprcSrc1 имеет координаты (10, 10, 100, 100), а *lprcSrc2, имеет координаты (50, 10, 150, 150), тогда функция устанавливает координаты прямоугольника, указанного при помощи lprcDst в (10, 10, 50, 100).

Поскольку приложения могут использовать прямоугольники для различных целей, функции прямоугольника не используют точную единицу измерения. Вместо этого все координаты прямоугольника и размеры подаются как знаковые, логические значения. Режим отображения и функция, в которой прямоугольник используется, определяют единицы измерения.

Смотри также

Обзор Прямоугольники, Функции, используемые прямоугольниками, IntersectRect, RECT, UnionRect

Размещение и совместимость SubtractRect
К Windows XP Да
л Windows 2000 Professional Да
и Windows NT Workstation Да версии 3.1 и выше
е Windows Me Да
н Windows 98 Да
т Windows 95 Да
 
С Windows Server 2003 Да
е Windows 2000 Server Да
р Windows NT Server Да версии 3.1 и выше
в    
е    
р    
Используемая библиотека User32.lib
Используемая DLL -
Заголовочный файл  
- объявлено в Winuser.h
- включено в Windows.h
Unicode Нет
Замечания по платформе Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz