Функции GDI Win-32, страница 13

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

Замечания

Приложение может восстановить данные для области,  вызывая функцию GetRegionData.

Windows 95 только: Области больше не ограничены кучей 64КБ.

Функция PathToRegion создает область от дорожки, которая отобрана в указанный контекст устройства.

HRGN PathToRegion (

HDC hdc       // обработка контекста устройства

);       

Параметры

Hdc

Опознает контекст устройства, который содержит закрытую дорожку.

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

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

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

Замечания

Контекст устройства, идентифицированный параметром hdc должен содержать закрытую дорожку.

После того, как PathToRegion преобразовывает дорожку в область, Windows отказывается от закрытия дорожки указанного контекста устройства.

Функция CreateDC создает контекст устройства (DC) для устройства,  используя указанное имя.

HDC CreateDC (

LPCTSTR lpszDriver,            // адрес строки, определяющей имя драйвера

LPCTSTR lpszDevice,           // адрес строки, определяющей имя устройства 

LPCTSTR lpszOutput,            // не используется; указатель на пустой набор

CONST DEVMODE *lpInitData           // адрес необязательных данных принтера

);       

Параметры

LpszDriver

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

Windows 95: В Win32-разрядных приложениях, этот параметр игнорируется и должен быть пустой, с одним исключением: Вы можете получить контекст устройства вывода,  определяя указателем строку "ПОКАЗ" пустой. Если параметр - "ПОКАЗ", все другие параметры должны быть пустые.

LpszDevice

Указатель на строку, которая определяет имя определенного используемого устройства печати, как показано Менеджером Печати (например, " Epson FX-80 "). Это - не марка модели принтера. Параметр LpszDevice должен использоваться.

LpszOutput

Этот параметр игнорируется. Не используйте его в Win32 приложениях.

LpInitData

Указатель на структуру DEVMODE, содержащую определенные данные инициализации для драйвера устройства. Функция DocumentProperties восстанавливает эту структуру, заполненную для данного устройства.

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

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

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

Замечания

Приложения, написанные для более ранних версий Windows использовали параметр lpszOutput, чтобы определить имя порта или печать файла. Win32 приложения не могут определить имя порта. Win32-based приложения может печатать файл,  вызывая функцию StartDoc со структурой DOCINFO, чей член lpszOutput определяет дорожку имени файла.

Когда Вы больше не нуждаетесь в контексте устройства, вызовите функцию DeleteDC, чтобы удалить его.

Функция DeleteDC удаляет указанный контекст устройства (DC).

BOOL DeleteDC (

HDC hdc       // обработка контекста устройства

);       

Параметры

Hdc

Опознает контекст устройства.

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

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

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

Замечания

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

Функция CreateCompatibleDC создает контекст устройства памяти (DC) совместимый с указанным устройством.

HDC CreateCompatibleDC (

HDC hdc       // обработка контекста устройства памяти

);       

Параметры

Hdc

Опознает контекст устройства. Если эта обработка пустая, функция создает контекст устройства памяти, совместимый с текущим экраном приложения.

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