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; Мы поможем в написании вашей работы!

Поделиться с друзьями:






Мы поможем в написании ваших работ!