Функция OleMetafilePictFromIconAndLabel (ole2.h)
Создает метафайл, в котором нарисованы указанные значок и метка.
Синтаксис
HGLOBAL OleMetafilePictFromIconAndLabel(
[in] HICON hIcon,
[in] LPOLESTR lpszLabel,
[in] LPOLESTR lpszSourceFile,
[in] UINT iIconIndex
);
Параметры
[in] hIcon
Дескриптор значка, который должен быть врисован в метафайл. Этот параметр может принимать значение NULL. Если hIcon имеет значение NULL, эта функция возвращает значение NULL без создания метафайла.
[in] lpszLabel
Метка значка. Этот параметр может принимать значение NULL. Если lpszLabel имеет значение NULL, результирующий метафайл не будет содержать метку.
[in] lpszSourceFile
Путь и имя файла значка. Эту строку можно получить через пользовательский интерфейс или из базы данных регистрации. Этот параметр может принимать значение NULL.
[in] iIconIndex
Расположение значка в файле с именем lpszSourceFile, выраженное в виде смещения в байтах от начала файла.
Возвращаемое значение
Глобальный дескриптор структуры METAFILEPICT , содержащий значок и метку. Метафайл использует режим сопоставления MM_ANISOTROPIC.
При возникновении ошибки возвращаемый дескриптор имеет значение NULL. В этом случае вызывающий объект может вызвать GetLastError для получения дополнительных сведений.
Комментарии
Эта функция вызывается oleGetIconOfFile и OleGetIconOfClass.
Если значение lpszSourceFile не равно NULL , а iIconIndex не равно 0, имя исходного файла, переданного в lpszSourceFile , и индекс, переданный iIconIndex , добавляются в созданный метафайл в качестве записи комментария.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | ole2.h |
| Библиотека | Ole32.lib |
| DLL | Ole32.dll |