Читать онлайн «Русский справочник по Win32 API». Страница 18

Значение

Windows 2. x

0x00020000

Windows 3.x

0x00030000

Все Win 32 приложения должны использовать для иконок и курсоров формат Windows 3. x .

cxDesired - определяет желаемую ширину иконки или курсора в пикселях. Если значение этого параметра равно нулю, функция использует значения метрики системы SM _ CXICON или SM _ CXCURSOR для установки ширины.

cyDesired - определяет желаемую высоту иконки или курсора в пикселях. Если значение этого параметра равно нулю, функция использует значения метрики системы SM _ CXICON или SM _ CXCURSOR для установки высоты.

uFlags - определяет комбинацию из следующих значений:

Значение

Пояснение

LR _ DEFAULTCOLOR

Используется цветовой формат по умолчанию.

LR _ MONOCHROME

Создается монохромная иконка или курсор.

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

В случае успеха возвращается дескриптор иконки или курсора.

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

Комментарии

Функции CreateIconFromResourceEx, CreateIconFromResource , CreateIconIndirect, GetIconInfo и LookupIconIdFromDirectoryEx позволяют приложениям оболочки и браузерам иконок проверять и использовать ресурсы всей системы.

См. также

BITMAPINFOHEADER, CreateIconFromResource, CreateIconIndirect, GetIconInfo, LoadResource, LookupIconIdFromDirectoryEx .

Функция CreateIconIndirect создает иконку или курсор по информации из структуры типа ICONINFO .

HICON CreateIconIndirect (

PICONINFO piconinfo // указатель на структуру с

// информацией об иконке

);

Параметры

piconinfo - указывает на структуру типа ICONINFO , которую функция использует для создания иконки или курсора.

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

В случае успеха возвращается дескриптор созданной иконки или курсора.

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

Комментарии

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

Когда вы закончили использовать иконку, вызовите функцию DestroyIcon .

См . также

DestroyIcon, ICONINFO .

Функция GetIconInfo извлекает информацию об указанной иконке или курсоре.

BOOL GetIconInfo (

HICON hIcon , дескриптор иконки

PICONINFO piconinfo // адрес структуры иконки

);

Параметры

hIcon - идентифицирует иконку или курсор. Для извлечения информации о стандартной иконке или курсоре, укажите одно из следующих значений:

Значение

Описание

IDC _ ARROW

Обычный курсор-стрелка.

IDC _ IBEAM

Курсор в виде буквы " I ".

IDC _ WAIT

Курсор "большие песочные часы".

IDC _ CROSS

Курсор-перекрестие.

IDC _ UPARROW

Курсор "стрелка вверх".

IDC _ SIZE

Только Windows NT : четырехконечная стрелка

IDC _ ICON

Только Windows NT : пустая иконка.

IDC _ SIZENWSE

Курсор изменения размера. Ориентирован с северо-запада на юго-восток.

IDC _ SIZENESW

Курсор изменения размера. Ориентирован с северо-востока на юго-запад.

IDC _ SIZEWE

Горизонтальный курсор изменения размера.

IDC _ SIZENS

Вертикальный курсор изменения размера.

IDC _ SIZEALL

Курсор изменения всех размеров. То же, что и IDC _ SIZE.

IDC _ NO

Перечеркнутый наискосок круг.

IDC _ APPSTARTING

Курсор "маленькие песочные часы со стрелкой".

IDI _ APPLICATION

Иконка приложения по умолчанию.

IDI _ ASTERISK

Звездочка (используется в информационных сообщениях).

IDI _ EXCLAMATION

Восклицательный знак (используется в предупредительных сообщениях).

IDI _ HAND

Иконка, имеющая форму руки (используется в серьезных предупредительных сообщениях).

IDI _ QUESTION

Вопросительный знак (используется в вопросительных сообщениях).

IDI_WINLOGO

Лого Windows.

piconinfo - указывает на структуру типа ICONINFO . Функция заполняет члены структуры.

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

В случае успеха возвращается ненулевое значение, и функция заполняет члены структуры типа ICONINFO .

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

Комментарии

GetIconInfo создает битовые изображения для членов hbmMask и hbmColor структуры типа ICONINFO . Вызывающее приложение должно управлять этими изображениями и удалять их, когда в них отпадает необходимость.

См. также

CreateIcon, CreateIconFromResource, CreateIconIndirect, DestroyIcon, DrawIcon, DrawIconEx, ICONINFO, LoadIcon, LookupIconIdFromDirectory .

Функция ClientToScreen преобразует клиентские координаты указанной точки в экранные координаты.

BOOL ClientToScreen (

HWND hWnd , // дескриптор окна для исходных координат

LPPOINT lpPoint // указатель на структуру, содержащую

// экранные координаты

);

Параметры

hWnd - идентифицирует окно, чья клиентская область используется для преобразования.

lpPoint - указывает на структуру типа POINT , которая содержит преобразуемые координаты. В случае успеха в эту структуру копируются новые экранные координаты.

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

В случае успеха возвращается ненулевое значение.

В случае неудачи возвращается нуль.

Комментарии

Функция ClientToScreen замещает клиентские координаты в структуре типа POINT экранными координатами. Экранные координаты относительны верхнего левого угла экрана.

См. также

MapWindowPoints, POINT, ScreenToClient .

Функция CombineTransform объединяет два преобразования " мировое пространство - пространство страницы " (world-space to page-space transformations).

BOOL CombineTransform (

LPXFORM lpxformResult , // указатель на комбинированное преобразование

CONST XFORM * lpxform 1 , // указатель на первое преобразование

CONST XFORM * lpxform 2 // указатель на второе преобразование

);

Параметры

lpxformResult - указывает на структуру типа XFORM , которая получает комбинированное преобразование.

lpxform 1 - указывает на структуру типа XFORM , которая идентифицирует первое преобразование.

lpxform 2 - указывает на структуру типа XFORM , которая идентифицирует второе преобразование.

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

В случае успеха возвращается ненулевое значение.

В случае неудачи возвращается нуль.

Комментарии

Применение комбинированного преобразования аналогично применению сначала первого преобразования, затем второго.

Три преобразования не обязательно должны быть раздельными. Например, lpxform 1 может указывать на ту же структуру типа XFORM , что и lpxformResult .

См. также

GetWorldTransform, ModifyWorldTransform, SetWorldTransform, XFORM .

Функция GetGraphicsMode извлекает текущий графический режим для указанного контекста устройства.

int GetGraphicsMode (

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

);

Параметры

hdc - идентифицирует контекст устройства.

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