LoadIcon

O LoadIcon função carrega o recurso especificado ícone do executável (.Arquivo EXE) associado com uma instância aplicativo. Esta função foi substituída pela função LoadImage

(HICON LoadIcon HINSTANCE  hInstance, / / identificador de instância de aplicativoLPCTSTRlpIconName / / nome do ícone recurso Cadeia de caracteres ou ícone / / identificador);
 

Parâmetros

hInstance

Identificador para uma instância do módulo cujo arquivo executável contém o ícone a ser carregado. Este parâmetro deve ser NULL quando um padrão ícone está sendo carregado.

lpIconName

Ponteiro para uma seqüência de caracteres null-terminated que contém o nome do recurso de ícone a ser carregado. Como alternativa, este parâmetro pode conter o identificador de recurso em de baixo palavra ordem e zero de alta-ordem palavra. Use o MAKEINTRESOURCE macro para criar esse valor.

Para usar um dos ícones predefinidos, defina o parâmetro de hInstance para NULL e o parâmetro lpIconName para um dos seguintes valores:

Valor	Descrição
IDI_APPLICATION	Ícone de aplicativo padrão.
IDI_ASTERISK	Mesmo que IDI_INFORMATION.
IDI_ERROR	Ícone em forma de mão.
IDI_EXCLAMATION	Mesmo que IDI_WARNING.
IDI_HAND	Mesmo que IDI_ERROR.
IDI_INFORMATION	Ícone de asterisco.
IDI_QUESTION	Ícone de ponto de interrogação.
IDI_WARNING	Ícone de ponto de exclamação.
IDI_WINLOGO	Ícone de logotipo do Windows.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é um identificador para o ícone recém-carregada.

Se a função falhar, o valor de retorno é NULL. Para informações de erro estendidas get, chamar GetLastError.

Observações

LoadIcon carrega o recurso ícone somente se ele não tenha sido carregado; caso contrário, ele recupera um identificador para o recurso existente. A função pesquisa o recurso de ícone para o ícone mais apropriado para o atual Exibir. O recurso de ícone pode ser um bitmap colorido ou monocromático.

LoadIcon só pode carregar um ícone cujo tamanho está de acordo com os valores métricos sistema SM_CXICON e SM_CYICON. Use a função LoadImage para carregar ícones de outros tamanhos.

Windows CE: Não há suporte para ícones predefinidos (IDI _ *).

Em Windows CE 1.0, o ícone deve ser um dois bit por ícone pixel (.ic2) ou um ícone monocromático.

Ver também

Visão geral de ícones, ícone funções, CreateIcon, LoadImage, MAKEINTRESOURCE

Index