Русский справочник по Win32 API
Шрифт:
В случае неудачи возвращается NULL .
Комментарии
Перед тем, как приложение сможет использовать контекст устройства в памяти для операций рисования, оно должно выбрать в контекст устройства битовый образ с корректной шириной и высотой. Как только битовый образ выбран, контекст устройства может быть использован для подготовки изображений, которые будут скопированы на экран или принтер.
Функция CreateCompatibleDC может быть использована только с теми устройствами, которые поддерживают растровые операции.
В случае, если в контексте устройства отпала необходимость, вызовите функцию DeleteDC для его удаления.
См. также
CreateCompatibleBitmap, DeleteDC, GetDeviceCaps .
DeleteDC
Функция DeleteDC удаляет заданный контекст устройства.
BOOL DeleteDC (
HDC hdc // дескриптор контекста устройства
);
Параметры
hdc– идентифицирует контекст устройства.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль.
Комментарии
Приложение не должно удалять контекст устройства, чей дескриптор был получен вызовом функции GetDC . Вместо этого приложение должно вызвать функцию ReleaseDC для освобождения контекста устройства.
См. также
CreateDC, GetDC, ReleaseDC .
EnumObjects
Функция EnumObjects перечисляет перья или кисти, доступные для указанного контекста устройства. Эта функция вызывает определяемую приложением функцию обратного вызова один раз для каждого их доступных объектов, предоставляя данные, описывающие объект. EnumObjects продолжает вызывать функцию обратного вызова до тех пор, пока она не вернет нуль или не будут перечислены все доступные объекты.
int EnumObjects (
HDC hdc , // дескриптор контекста устройства
int nObjectType , // идентификатор типа объекта
GOBJENUMPROC lpObjectFunc , // указатель на функцию обратного вызова
LPARAM lParam // указатель на предоставляемые приложением данные
);
hdc– идентифицирует контекст устройства.
nObjectType– определяет тип объекта. Может принимать значение OBJ_BRUSH или OBJ_PEN .
lpObjectFunc– указатель на определяемую приложением функцию обратного вызова. Для дополнительной информации об этой функции смотрите описание функции EnumObjectsProc .
lParam– указывает на определяемые приложением данные. Данные передаются в функцию обратного вызова вместе с информацией об объекте.
Возвращаемые значения
Возвращаемое значение определяет последнее значение, возвращенное функцией обратного вызова. Его смысл определяется пользователем. Возвращается -1 в случае наличия слишком большого количества объектов, подлежащих перечислению. В этом случае функция обратного вызова не вызывается.
См. также
EnumObjectsProc, GetObject .
GetDC
Функция GetDC извлекает дескриптор контекста дисплея для клиентской области указанного окна. Контекст дисплея может быть использован в последующих функциях GDI для рисования в клиентской области окна.
Эта функция извлекает общий, классовый или частный контекст устройства в зависимости от стиля класса, указанного для заданного окна. Для общих контекстов устройства GetDC присваивает контексту атрибуты по умолчанию каждый раз при извлечении контекста устройства. Для классовых и частных контекстов устройства GetDC оставляет ранее присвоенные атрибуты без изменений.
HDC GetDC (
HWND hWnd // дескриптор окна
);
Параметры
hWnd– идентифицирует окно, чей контекст устройства извлекается.
Возвращаемые значения
В случае успеха возвращается контекст устройства для клиентской области указанного окна.
В случае неудачи возвращается нуль.
Комментарии
После рисования с общим контекстом устройства должна быть вызвана функция ReleaseDC для освобождения контекста устройства. Классовые и частные контексты устройства не должны освобождаться. Количество контекстов устройства ограничено только объемом доступной памяти.
См. также
ReleaseDC, GetWindowDC .