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 |
标头 | ole2.h |
Library | Ole32.lib |
DLL | Ole32.dll |