Функция 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 извлекает дескриптор контекста дисплея для клиентской области указанного окна. Контекст дисплея может быть использован в последующих функциях GDI для рисования в клиентской области окна.
Эта функция извлекает общий, классовый или частный контекст устройства в зависимости от стиля класса, указанного для заданного окна. Для общих контекстов устройства GetDC присваивает контексту атрибуты по умолчанию каждый раз при извлечении контекста устройства. Для классовых и частных контекстов устройства GetDC оставляет ранее присвоенные атрибуты без изменений.
HDC GetDC (
HWND hWnd // дескриптор окна
);
Параметры
hWnd - идентифицирует окно, чей контекст устройства извлекается.
Возвращаемые значения
В случае успеха возвращается контекст устройства для клиентской области указанного окна.
В случае неудачи возвращается нуль.
Комментарии
После рисования с общим контекстом устройства должна быть вызвана функция ReleaseDC для освобождения контекста устройства. Классовые и частные контексты устройства не должны освобождаться. Количество контекстов устройства ограничено только объемом доступной памяти.
См. также
ReleaseDC, GetWindowDC .
Функция ResetDC обновляет данный контекст устройства плоттера или принтера, основываясь на информации в указанной структуре.
HDC ResetDC (
HDC hdc , // дескриптор контекста устройства
CONST DEVMODE * lpInitData // адрес структуры с информацией
// о контексте устройства
);
Параметры
hdc - идентифицирует контекст устройства, подлежащий обновлению.
lpInitData - указывает на структуру типа DEVMODE , содержащую информацию о новом контексте устройства.
Возвращаемые значения
В случае успеха возвращается дескриптор оригинального исходного контекста устройства.
В случае неудачи возвращается NULL .
Комментарии
Приложение обычно использует функцию ResetDC при получении сообщения WM _ DEVMODECHANGE. ResetDC также может быть использована для изменения ориентации бумаги или полей бумаги при печати документа. Функция ResetDC не может быть использована для изменения имени драйвера устройства, имени устройства или выходного порта. Когда пользователь изменяет соединение с портом или имя устройства, приложение должно удалить исходный контекст устройства и создать новый контекст с новой информацией.
См. также
DeviceCapabilities, DEVMODE, Escape .
