CDC::SelectClipRgn

Статья
02/20/2013

Выделяет заданную область в качестве текущей областью обрезки для контекста устройства.

int SelectClipRgn(
   CRgn* pRgn 
);
int SelectClipRgn(
   CRgn* pRgn,
   int nMode 
);

Параметры

pRgn
Определяет область, которую необходимо выделить.
- Для первой версии этой функции, если это значение NULL, то выделена всю клиентскую область и по-прежнему закреплен в окно выходные данные.
- Для второй версии этой функции, этот дескриптор может быть NULL только в том случае, если режиму RGN_COPY определен.
nMode
Указывает операцию, которую необходимо выполнить.Она должна быть одно из следующих значений:
- RGN_AND Новая вырезанная область объединяет перекрывающиеся области текущей вырезанной области и региона, указанных pRgn.
- RGN_COPY Новая вырезанная область копия области, указанной pRgn.Эта функциональность идентична первой версии SelectClipRgn.Если область, указанная pRgnNULL, новая вырезанная область по умолчанию, область области отсечения (null).
- RGN_DIFF Новая вырезанная область объединяет области текущей вырезанной области с эти области исключенные из области, указанной pRgn.
- RGN_OR Новая вырезанная область объединяет текущую вырезанную область и область, определенные pRgn.
- RGN_XOR Новая вырезанная область объединяет текущую вырезанную область и область, определенные pRgn но исключает все перекрывающиеся области.

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

Тип области.Он может быть любой из следующих значений:

Новая вырезанная область COMPLEXREGION есть перекрывающихся границы.
Контекст устройства или область ERROR недопустимыми.
NULLREGION Новая вырезанная область пуста.
Новая вырезанная область SIMPLEREGION нет пересекающихся границы.

Заметки

Только копию выбранной области используется.Сама область можно выбрать для множества других контекстов устройства или она может быть удален.

Функция предполагает, что координаты для заданной области определяются в единицах устройства.Предоставлены необходимые для текста поддержки устройств принтера на более высоком разрешении, чем вывода графики наследование для сохранения точность было необходимо представить метрики текста.Эти устройства " единиц устройств на более высоком разрешении, т е в единицах текста.Эти координаты устройства затем масштаб графический, так что сопоставление нескольких устройств из отчета единиц только 1 рисунок единица измерения.Следует всегда вызывать функцию SelectClipRgn использование единиц текста.

Приложения, которые должны выполнить масштабирование графики объект в GDI могут использовать избежать принтера GETSCALINGFACTOR чтобы задать коэффициент масштабирования.Этот коэффициент масштабирования влияет на отсечение.Если область используется для закрепления графики, то GDI делит координаты фактором масштабирования.Если область используется для закрепления текста GDI не выполняет никакой корректировку масштабирования.Коэффициент масштабирования 1 приводит к тому, что координаты быть разделенным 2; коэффициент масштабирования 2 координаты для деления 4; и т д