Русский справочник по Win32 API - Тарас Сорока
Шрифт:
Интервал:
Закладка:
Значение
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
Функция CreateIconIndirect создает иконку или курсор по информации из структуры типа ICONINFO .
HICON CreateIconIndirect (
PICONINFO piconinfo // указатель на структуру с
// информацией об иконке
);
Параметры
piconinfo - указывает на структуру типа ICONINFO , которую функция использует для создания иконки или курсора.
Возвращаемые значения
В случае успеха возвращается дескриптор созданной иконки или курсора.
В случае неудачи возвращается NULL . Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
Комментарии
Система копирует битовые образы в структуру типа ICONINFO перед созданием иконки или курсора. Приложение должно продолжать управлять исходными битовыми образами и удалить их при отсутствии в них дальнейшей необходимости.
Когда вы закончили использовать иконку, вызовите функцию DestroyIcon .
См . также
DestroyIcon, ICONINFO .
GetIconInfo
Функция 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
Функция ClientToScreen преобразует клиентские координаты указанной точки в экранные координаты.
BOOL ClientToScreen (
HWND hWnd , // дескриптор окна для исходных координат
LPPOINT lpPoint // указатель на структуру, содержащую
// экранные координаты
);
Параметры
hWnd - идентифицирует окно, чья клиентская область используется для преобразования.
lpPoint - указывает на структуру типа POINT , которая содержит преобразуемые координаты. В случае успеха в эту структуру копируются новые экранные координаты.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль.
Комментарии
Функция ClientToScreen замещает клиентские координаты в структуре типа POINT экранными координатами. Экранные координаты относительны верхнего левого угла экрана.
См. также
MapWindowPoints, POINT, ScreenToClient .
CombineTransform
Функция 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
Функция GetGraphicsMode извлекает текущий графический режим для указанного контекста устройства.
int GetGraphicsMode (
HDC hdc // дескриптор контекста устройства
);
Параметры
hdc - идентифицирует контекст устройства.
Возвращаемые значения