CopyCursor, DrawIcon, DrawIconEx. 10 страница
ChooseFont
Функция ChooseFont создает стандартное диалоговое окно выбора шрифта, которое позволяет пользователю выбрать атрибуты для логического шрифта. Эти атрибуты включают в себя имя гарнитуры шрифта, стиль (жирный, наклонный или нормальный), размер, эффекты (подчеркивание, зачеркивание и цвет текста) и написание символов (или набор символов).
BOOL ChooseFont (
LPCHOOSEFONT lpcf // указатель на структуру с инициализирующими данными
);
Параметры
lpcf ‑ указывает на структуру типа CHOOSEFONT , которая содержит информацию, используемую для инициализации диалогового окна. Когда ChooseFont возвращает управление, структура содержит информацию о выбранном пользователем шрифте.
Возвращаемые значения
Если пользователь нажимает кнопку ОК в диалоговом окне, возвращается ненулевое значение. Члены структуры типа CHOOSEFONT показывают выбор пользователя.
Если пользователь нажал кнопку Cancel, или закрыл диалоговое окно, или произошла ошибка ‑ возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию CommDlgExtendedError , которая может вернуть одно из следующих значений:
CDERR_FINDRESFAILURE
CDERR_NOHINSTANCE
CDERR_INITIALIZATION
CDERR_NOHOOK
CDERR_LOCKRESFAILURE
CDERR_NOTEMPLATE
CDERR_LOADRESFAILURE
CDERR_STRUCTSIZE
CDERR_LOADSTRFAILURE
CFERR_MAXLESSTHANMIN
CDERR_MEMALLOCFAILURE
CFERR_NOFONTS
CDERR_MEMLOCKFAILURE
Комментарии
Вы можете предоставить функцию‑ловушку (hook procedure) CCHookProc для диалогового окна. Функция‑ловушка может обрабатывать сообщения, отправляемые диалоговому окну. Для использования функции установите флаг CC_ENABLEHOOK в члене Flags структуры типа CHOOSEFONT и укажите адрес функции в члене lpfnHook .
|
|
Функция‑ловушка может отправлять диалоговому окну сообщения WM _ CHOOSEFONT _ GETLOGFONT, WM _ CHOOSEFONT _ SETFLAGS и WM _ CHOOSEFONT _ SETLOGFONT для получения и установки текущих значений флагов в диалоговом окне.
См. также
CFHookProc, CHOOSEFONT, CommDlgExtendedError, LOGFONT , WM_CHOOSEFONT_GETLOGFONT, WM_CHOOSEFONT_SETFLAGS, WM_CHOOSEFONT_SETLOGFONT.
Иконки
CopyIcon
Функция CopyIcon копирует заданную иконку в текущий модуль из другого модуля.
HICON CopyIcon (
HICON hIcon // дескриптор копируемой иконки
);
Параметры
hIcon ‑ идентифицирует копируемую иконку.
Возвращаемые значения
В случае успеха возвращается дескриптор на полученную копию иконки.
В случае неудачи возвращается NULL . Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
Комментарии
Функция CopyIcon позволяет приложению или динамически подключаемой библиотеке получить свой собственный дескриптор иконки, находящейся в другом модуле. Если другой модуль прекращает работу, приложение по‑прежнему может использовать скопированную иконку.
|
|
См . также
CopyCursor, DrawIcon, DrawIconEx.
CreateIcon
Функция CreateIcon создает иконку, которая имеет указанные размер, цвета и битовые шаблоны.
HICON CreateIcon (
HINSTANCE hInstance , // дескриптор экземпляра приложения
int nWidth , // ширина иконки
int nHeight , // высота иконки
BYTE cPlanes , // число плоскостей в битовой маске исключающее ИЛИ
BYTE cBitsPixel , // число бит на пиксель
// в битовой маске исключающее ИЛИ
CONST BYTE * lpbANDbits , // указатель на массив битовой маски И
CONST BYTE * lpbXORbits // указатель на массив битовой маски ИЛИ
);
Параметры
hInstance ‑ идентифицирует экземпляр модуля, создающего иконку.
nWidth ‑ определяет ширину иконки в пикселях.
nHeight ‑ определяет высоту иконки в пикселях.
cPlanes ‑ определяет число плоскостей в битовой маске исключающее ИЛИ иконки.
cBitsPixel ‑ определяет число бит на пиксель в битовой маске исключающее ИЛИ иконки.
lpbANDbits ‑ указатель на массив байт, который содержит битовые значения для маски И иконки. Такая битовая маска описывает монохромное изображение.
lpbXORbits ‑ указатель на массив байт, который содержит битовые значения для маски исключающее ИЛИ иконки. Такая битовая маска описывает зависимое от устройства цветное изображение.
|
|
Возвращаемые значения
В случае успеха возвращается дескриптор иконки.
В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
Комментарии
Значения параметров nWidth и nHeight должны указывать ширину и высоту, поддерживаемые текущим драйвером дисплея, потому что система не может создать иконки других размеров. Для определения того, какие ширина и высота поддерживаются драйвером дисплея, вызовите функцию GetSystemMetrics , указав значения SM _ CXICON и SM _ CYICON .
CreateIcon применяет следующую таблицу истинности для битовых масок.
Битовая маска И | Битовая маска исключающее ИЛИ | Отображение |
0 | 0 | Черное. |
0 | 1 | Белое. |
1 | 0 | Цвет экрана. |
1 | 1 | Обратный цвет экрана. |
См. также
GetSystemMetrics .
CreateIconFromResource
Функция CreateIconFromResource создает иконку или курсор из битов ресурса, описывающих иконку.
HICON CreateIconFromResource (
PBYTE presbits , // указатель на биты ресурса
DWORD dwResSize , // число бит в буфере
BOOL fIcon , // флаг иконки или курсора
DWORD dwVer // версия формата Windows
);
|
|
Параметры
presbits ‑ указывает на буфер, содержащий биты ресурса иконки или курсора. Эти биты обычно загружаются вызовами функций LookupIconIdFromDirectory (в Windows 95 вы также можете использовать функцию LookupIconIdFromDirectoryEx ) и LoadResource .
dwResSize ‑ определяет размер, в байтах, набора битов, на который указывает параметр presbits .
fIcon ‑ определяет, будет ли создаваться иконка или курсор. Если значение этого параметра равно TRUE, создается иконка. Иначе создается курсор.
dwVer ‑ определяет номер версии формата иконки или курсора для битов ресурса, на которые указывает параметр presbits . Параметр может принимать одно из следующих значений:
Формат | Значение |
Windows 2. x | 0x00020000 |
Windows 3.x | 0x00030000 |
Все Win 32 приложения должны использовать для иконок и курсоров формат Windows 3. x .
Возвращаемые значения
В случае успеха возвращается дескриптор иконки или курсора.
В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
Комментарии
Функции CreateIconFromResource, CreateIconIndirect, GetIconInfo и LookupIconIdFromDirectory (в Windows 95 также функции CreateIconFromResourceEx и LookupIconIdFromDirectoryEx ) позволяют приложениям оболочки и браузерам иконок проверять и использовать ресурсы всей системы.
См. также
CreateIconFromResourceEx, CreateIconIndirect, GetIconInfo, LoadResource, LookupIconIdFromDirectory, LookupIconIdFromDirectoryEx .
CreateIconFromResourceEx
Функция CreateIconFromResourceEx создает иконку или курсор из битов ресурса, описывающих иконку.
HICON CreateIconFromResourceEx (
PBYTE pbIconBits , // указатель на биты ресурса
DWORD cbIconBits , // число бит в буфере
BOOL fIcon , // флаг иконки или курсора
DWORD dwVersion , // версия формата Windows
int cxDesired , // желаемая ширина иконки или курсора
int cyDesired , // желаемая высота иконки или курсора
UINT uFlags
);
Параметры
pbIconBits ‑ указывает на буфер, содержащий биты ресурса иконки или курсора. Эти биты обычно загружаются вызовами функций LookupIconIdFromDirectory (в Windows 95 вы также можете использовать функцию LookupIconIdFromDirectoryEx ) и LoadResource .
cbIconBits ‑ определяет размер, в байтах, набора битов, на который указывает параметр pbIconBits .
fIcon ‑ определяет, будет ли создаваться иконка или курсор. Если значение этого параметра равно TRUE, создается иконка. Иначе создается курсор.
dwVersion ‑ определяет номер версии формата иконки или курсора для битов ресурса, на которые указывает параметр pbIconBits . Параметр может принимать одно из следующих значений:
Формат | Значение |
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 .
Дата добавления: 2021-01-21; просмотров: 58; Мы поможем в написании вашей работы! |
Мы поможем в написании ваших работ!