Função OleMetafilePictFromIconAndLabel (ole2.h)
Cria um metarquivo no qual o ícone e o rótulo especificados são desenhados.
Sintaxe
HGLOBAL OleMetafilePictFromIconAndLabel(
[in] HICON hIcon,
[in] LPOLESTR lpszLabel,
[in] LPOLESTR lpszSourceFile,
[in] UINT iIconIndex
);
Parâmetros
[in] hIcon
Manipule para o ícone que deve ser desenhado no metarquivo. Este parâmetro pode ser NULL. Se hIcon for NULL, essa função retornará NULL sem criar um metafile.
[in] lpszLabel
O rótulo do ícone. Este parâmetro pode ser NULL. Se lpszLabel for NULL, o metafile resultante não incluirá um rótulo.
[in] lpszSourceFile
O caminho e o nome do arquivo de ícone. Essa cadeia de caracteres pode ser obtida por meio da interface do usuário ou do banco de dados de registro. Este parâmetro pode ser NULL.
[in] iIconIndex
O local do ícone dentro do arquivo chamado por lpszSourceFile, expresso como um deslocamento em bytes desde o início do arquivo.
Retornar valor
Um identificador global para uma estrutura METAFILEPICT que contém o ícone e o rótulo. O metarquivo usa o modo de mapeamento MM_ANISOTROPIC.
Se ocorrer um erro, o identificador retornado será NULL. Nesse caso, o chamador pode chamar GetLastError para obter mais informações.
Comentários
Essa função é chamada por OleGetIconOfFile e OleGetIconOfClass.
Se lpszSourceFile não for NULL e iIconIndex não for 0, o nome do arquivo de origem passado em lpszSourceFile e o índice passado por iIconIndex serão adicionados ao metarquivo criado como um registro de comentário.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | ole2.h |
| Biblioteca | Ole32.lib |
| DLL | Ole32.dll |