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 . Параметр может принимать одно из следующих значений:
Формат
Значение
