Тарас Сорока - Русский справочник по Win32 API
- Название:Русский справочник по Win32 API
- Автор:
- Жанр:
- Издательство:неизвестно
- Год:неизвестен
- ISBN:нет данных
- Рейтинг:
- Избранное:Добавить в избранное
-
Отзывы:
-
Ваша оценка:
Тарас Сорока - Русский справочник по Win32 API краткое содержание
Русский справочник по Win32 API - читать онлайн бесплатно полную версию (весь текст целиком)
Интервал:
Закладка:
См . также
ExcludeClipRect.
OffsetClipRgn
Функция OffsetClipRgnперемещает область отсечения контекста устройства на указанные смещения.
int OffsetClipRgn(
HDC hdc , // дескриптор контекста устройства
int nXOffset , // смещение вдоль оси x
int nYOffset // смещение вдоль оси y
);
Параметры
hdc - идентифицирует контекст устройства.
nXOffset - определяет количество логических единиц для перемещения влево или вправо.
nYOffset - определяет количество логических единиц для перемещения вверх или вниз.
Возвращаемые значения
В случае успеха возвращаемое значение определяет сложность области и может быть одним из предопределенных значений:
|
Значение |
Пояснение |
|
COMPLEXREGION |
Область состоит более чем из одного прямоугольника. |
|
ERROR |
Произошла ошибка. |
|
NULLREGION |
Пустая область. |
|
SIMPLEREGION |
Область является одиночным прямоугольником. |
См. также
SelectClipRgn.
SelectClipPath
Функция SelectClipPathвыбирает текущий путь ( path ) в качестве области отсечения для контекста устройства, объединяя новую область отсечения с существующей, используя указанный режим.
BOOL SelectClipPath(
HDC hdc , // дескриптор контекста устройства
int iMode // режим отсечения
);
Параметры
hdc - идентифицирует контекст устройства пути.
iMode - определяет способ использования пути. Допустимы следующие значения:
|
Значение |
Пояснение |
|
RGN _ AND |
Новая область отсечения включает пересечение (перекрывающиеся участки) текущей области отсечения и текущего пути. |
|
RGN _ COPY |
Новой областью отсечения является текущий путь. |
|
RGN _ DIFF |
Новая область отсечения включает участки текущей области отсечения и участки, исключенные из текущего пути. |
|
RGN _ OR |
Новая область отсечения представляет собой объединение текущей области отсечения и текущего пути. |
|
RGN _ XOR |
Новая область отсечения включает в себя объединение текущей области отсечения и текущего пути, но без пересекающихся участков. |
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError. GetLastErrorможет возвращать один из следующих кодов ошибки:
ERROR_CAN_NOT_COMPLETE
ERROR_INVALID_PARAMETER
ERROR_NOT_ENOUGH_MEMORY
Комментарии
Контекст устройства, идентифицируемый значением параметра hdc , должен содержать замкнутый путь.
См. также
BeginPath, EndPath.
SelectClipRgn
Функция SelectClipRgnвыбирает область в качестве текущей области отсечения для указанного контекста устройства.
int SelectClipRgn(
HDC hdc , // дескриптор контекста устройства
HRGN hrgn // дескриптор выбираемой области
);
Параметры
hdc - идентифицирует контекст устройства.
hrgn - идентифицирует область, которая выбирается.
Возвращаемые значения
В случае успеха возвращаемое значение определяет сложность области и может быть одним из предопределенных значений:
|
Значение |
Пояснение |
|
COMPLEXREGION |
Область состоит более чем из одного прямоугольника. |
|
ERROR |
Произошла ошибка. |
|
NULLREGION |
Пустая область. |
|
SIMPLEREGION |
Область является одиночным прямоугольником. |
Комментарии
Используется только копия выбранной области. Сама область может быть выбрана для любого числа контекстов устройства или может быть удалена.
Функция SelectClipRgnполагает, что координаты для области являются координатами устройства.
Для удаления области отсечения контекста устройства, укажите в качестве дескриптора области NULL .
См. также
ExtSelectClipRgn.
SetMetaRgn
Функция SetMetaRgnпересекает текущую область отсечения для указанного контекста устройства с текущей метаобластью и сохраняет объединенную область как новую метаобласть для указанного контекста устройства. Область отсечения сбрасывается в нулевую область.
int SetMetaRgn(
HDC hdc // дескриптор контекста устройства
);
Параметры
hdc - идентифицирует контекст устройства.
Возвращаемые значения
В случае успеха возвращаемое значение определяет сложность области и может быть одним из предопределенных значений:
|
Значение |
Пояснение |
|
COMPLEXREGION |
Область состоит более чем из одного прямоугольника. |
|
ERROR |
Произошла ошибка. |
|
NULLREGION |
Пустая область. |
|
SIMPLEREGION |
Область является одиночным прямоугольником. |
Комментарии
Текущая область отсечения контекста устройства определяется пересечением его области отсечения и его метаобласти.
Функция SetMetaRgnдолжна вызываться только после того, как исходный контекст устройства приложения был сохранен функцией SaveDC.
См. также
GetMetaRgn, SaveDC.
Рисование
GetWindowRgn
Функция GetWindowRgnполучает копию оконной области окна. Оконная область окна устанавливается вызовом функции SetWindowRgn. Оконная область определяет участок внутри окна, в котором операционная система выполняет рисование. Операционная система не отображает части окна, лежащие вне оконной области.
int GetWindowRgn(
HWND hWnd , // дескриптор окна. чья оконная область извлекается функцией
HRGN hRgn // дескриптор области, которая получает копию
// оконной области
);
Параметры
hWnd - дескриптор окна, оконная область которого извлекается.
hrgn - дескриптор области. Эта область получает копию оконной области.
Возвращаемые значения
В случае успеха возвращаемое значение определяет сложность области и может быть одним из предопределенных значений:
|
Значение |
Пояснение |
|
COMPLEXREGION |
Область состоит более чем из одного прямоугольника. |
|
ERROR |
Произошла ошибка. |
|
NULLREGION |
Пустая область. |
|
SIMPLEREGION |
Область является одиночным прямоугольником. |
Комментарии
Читать дальшеИнтервал:
Закладка:
