Растровые изображения, пиктограммы и метафайлы, страница 10

Члены flcon

BOOL. Устанавливается в значение TRUE для создания пиктофаммы. Устанавливается в значение FALSE для создания курсора.

xHotspol

DWORD. Координата д: активной области курсора. Это значение для пиктофаммы игнорируется.

yHotspot

DWORD. Координата у активной области курсора. Это значение для пиктограммы игнорируется.

hbmMask

HBITMAP. Растровое изображение двоичной маски пиктофаммы. Если эта структура определяет черно-белую пиктофамму, то двоичная маска формируется так, что верхняя половина составляет двоичную маску AND пиктофаммы, а нижняя половина — двоичную маску XOR пиктофаммы. Если же эта структура определяет цветную пиктофамму, то маска определяет только двоичную маску AND пиктограммы.

hbmColor

HBITMAP. Цветное расфовое изображение пиктофаммы. Необязательное значение, если структура определяет черно-белую пиктофамму. Двоичная маска AND парамефа hbmMask применяется к растровому изображению назначения с флажком SRCAND, затем цветное растровое изображение применяется (в операции XOR) к растровому изображению назначения с использованием флажка SRCINVERT.

Пример

В следующем примере для создания пиктофаммы из двух расфовых изображений применяется функция Createlconlndirect, когда пользователь выбирает пункт меню Test!. Растровые изображения и полученная пиктофам-ма отображаются в клиентской области окна, как показано на рис. 13.8.

DeleteEnhMetaFile                       • Windows 98   • Windows 2000

Описание

Функция DeleteEnhMetaFile позволяет удалить расширенный метафайл из памяти. Если расширенный метафайл хранится в памяти, эта функция удаляет указанный метафайл. Если метафайл хранится на диске, функция удаляет дескриптор метафайла, но не уничтожает сам метафайл.

Синтаксис

BOOL DeleteEnhMetaFile( HENHMETAFILE hemf)

Параметры hemf

HENHMETAFILE Дескриптор расширенного метафайла.

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

BOOL. В случае успешного выполнения — TRUE; в ином случае возвращаемое значение — FALSE.

Включаемый файл

wingdi.h

См. также

CreateEnhMetaFile, CloseEnhMetaFile, GetEnhMetaFile

Пример

См. пример для функции CreateEnhMetaFile.

Destroylcon                               • Windows 98   • Windows 2000

Описание

Функция Destroylcon позволяет уничтожить пиктограмму, созданную с помощью функции Createlcon и освободить память, занимаемую пиктограммой. Функция Destroylcon не должна применяться для уничтожения пиктограммы, которая не была создана функцией Createlcon.

Синтаксис

BOOL Destroylcon( HICON hlcon )

Параметры

hlcon

HICON. Дескриптор пиктограммы, которая должна быть уничтожена. Пиктограмма не должна использоваться.

Возвращаемое

BOOL. В случае успешного выполнения — TRUE; в ином случае

значение Включаемый файл

возвращаемое значение — FALSE, winuser.h

См. также

Createlcon, CreatelconFromResource, CreatelcbnFromResourceEx, Createlconlndirect

Пример

См. пример для функции Createlcon.

Drawlcon                                 • Windows 98   • Windows 2000

Описание

Функция Drawlcon позволяет вывести пиктограмму в клиентской области окна, принадлежащего указанному контексту устройства (DC). Эта пиктограмма обычно загружается из данных ресурса с использованием функций Loadlcon или Loadlmage. Она может быть также создана с помощью функции Createlcon. Для корректной работы этой функции контекст устройства должен находиться в режиме отображения MMJTEXT.

Синтаксис

BOOL Drawlcon( HDC hDC, int X, tat Y, HICON hlcon )

Параметры hDC

HDC. Дескриптор контекста устройства для окна, в котором должна быть выведена пиктограмма.

X

int. Логическая координата х левого верхнего угла пиктограммы.

Y

int. Логическая координата у левого верхнего угла пиктограммы.

hlcon

HICON. Дескриптор вводимой пиктограммы.

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

BOOL. В случае успешного выполнения — TRUE; в ином случае возвращаемое значение — FALSE.

Включаемый файл

winuser.h

См. также

Loadlcon, Loadlmage, Createlcon

Пример

См. пример для функции Copy Icon.

DrawlconEx                               • Windows 98   • Windows 2000

Описание

Функция DrawlconEx позволяет вывести пиктограмму или курсор в клиентской области окна, принадлежащего указанному контексту устройства (DC), выполняя при этом заданные растровые операции, а также растягивая или сжимая пиктограмму или курсор в соответствии с заданными параметрами.

Синтаксис

BOOL DrawIconEx( HOC hDC, tat X, tat У, HICON hlcon, tat ex, tat cy, UINT iStepIfAniCur, HBRUSH hbrHickerFreeDraw, UINT uFlags )

Параметры HOC

HDC. Дескриптор контекста устройства для окна, в котором должна быть выведена пиктограмма.

X

int. Логическая координата х левого верхнего угла пиктограммы или курсора.

Y

int. Логическая координата у левого верхнего угла пиктограммы или курсора.

hlcon

HICON. Дескриптор пиктограммы, которая должна быть выведена.

ex

int. Логическая ширина пиктограммы или курсора.

су

int. Логическая высота пиктограммы или курсора.

IStepIfAniCur

UINT. Индекс рамки, которая должна быть выведена, если параметр hlcon обозначает анимационный курсор.

HbrFlickerFreeDraw

HBRUSH. Дескриптор кисти, позволяющей выполнить вывод без мерцания, которая должна быть выбрана для контекста устройства, обозначенного параметром hDC.

и Flags

UINT. Флажки вывода. Этот параметр может иметь одно из значений, перечисленных в табл. 13.9.

Таблица 13.9. Значения параметра uFlags функции DrawlconEx

Значение

Описание

DI_COMPAT

Вывести пиктограмму или курсор с использованием изображения, предусмотренного в системе по умолчанию.

DI_DEFAULTSIZE

Вывести пиктограмму или курсор заданной по умолчанию ширины, игнорируя параметры сх и су.

DIJMAGE

Выполнить растровую операцию, указанную параметром г op/mage.

DI_MASK

Выполнить растровую операцию, указанную параметром ropMask.

DI_NORMAL

Комбинация значений DIJMAGE и DI_MASK.

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

BOOL. В случае успешного выполнения — TRUE; в ином случае возвращаемое значение — FALSE.

Включаемый файл

winuser.h

См. также

Loadlmage, Copylmage

Пример

См. пример для функции CreatelconFromResourceEx

EnumEnhMetaFile                        • Windows 98   • Windows 2000

Описание

Функция EnumEnhMetaFile перебирает записи в расширенном метафайле, извлекая каждую запись и передавая ее функции обратного вызова, которая определена в приложении. Функция продолжает последовательно перебирать записи до тех пор, пока не будет обработана последняя запись или пока функция обратного вызова не возвратит 0.