Compartilhar via


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

Confira também

OleGetIconOfClass

OleGetIconOfFile