LoadImage

O LoadImage função carrega um ícone, cursor ou bitmap.

Alça LoadImage ( HINSTANCE  hinst, / / identificador da instância que contém a imagemLPCTSTRlpszName, / / nome ou identificador de imagemUINTuType, / / tipo de imagemintcxDesired, / / desejado largura intcyDesired, / / desejado alturaUINTfuLoad / / carregar bandeiras);
 

Parâmetros

hinst

Identificador para uma instância do módulo que contém a imagem a ser carregado. Para carregar uma imagem OEM, defina este parâmetro como zero.

lpszName

Identificador para a imagem para carregar.

Se hinst parâmetro é não-NULL e o parâmetro fuLoad não inclui LR_LOADFROMFILE, lpszName é um ponteiro para uma seqüência de caracteres null-terminated que contém o nome do recurso de imagem no módulo hinst.

Se hinst é NULL e LR_LOADFROMFILE não for especificado, a baixa palavra ordem desse parâmetro deve ser o identificador da imagem OEM para carregar. Os identificadores de imagem OEM são definidos no WINUSER.H e têm os seguintes prefixos:

Prefixo	Significado
OBM _	OEM bitmaps
OIC _	Ícones de OEM
OCR_	Cursores de OEM

Se o parâmetro fuLoad inclui o valor LR_LOADFROMFILE, lpszName é o nome do arquivo que contém a imagem.

uType

Especifica o tipo de imagem a ser carregado. Este parâmetro pode ser uma dos seguinte valores:

Valor	Significado
IMAGE_BITMAP	Carrega um bitmap.
IMAGE_CURSOR	Carrega um cursor.
IMAGE_ICON	Carrega um ícone.

cxDesired

Especifica a largura, em pixels, do ícone ou cursor. Se este parâmetro é zero e o parâmetro de fuLoad é LR_DEFAULTSIZE, a função usa o valor métrico sistema SM_CXICON ou SM_CXCURSOR para definir a largura. Se este parâmetro é zero e LR_DEFAULTSIZE não é usado, a função usa a largura de recurso real.

cyDesired

Especifica a altura, em pixels, do ícone ou cursor. Se este parâmetro é zero e o parâmetro de fuLoad é LR_DEFAULTSIZE, a função usa o valor métrico sistema SM_CYICON ou SM_CYCURSOR para definir a altura. Se este parâmetro é zero e LR_DEFAULTSIZE não é usado, a função usa a altura de recurso real.

fuLoad

Especifica uma combinação do seguinte valores:

Valor	Significado
LR_DEFAULTCOLOR	A bandeira de padrão; Ele não faz nada. Tudo isto significa é "não LR_MONOCHROME".
LR_CREATEDIBSECTION	Quando o parâmetro uType especifica IMAGE_BITMAP, faz com que a função retornar um bitmap seção DIB em vez de um bitmap compatível. Este sinalizador é útil para carregar um bitmap sem mapeá-lo para as cores do dispositivo de exibir.
LR_DEFAULTSIZE	Utiliza a largura ou altura especificada pelos valores métricos sistema de cursores ou ícones, se os valores de cxDesired ou cyDesired são definidos como zero. Se este sinalizador não for especificado e cxDesired e cyDesired são definidas como zero, a função usa o tamanho de recurso real. Se o recurso contém várias imagens, a função usa o tamanho da primeira imagem.
LR_LOADFROMFILE	Carrega a imagem do arquivo especificado pelo parâmetro lpszName . Se este sinalizador não for especificado, lpszName é o nome do recurso.
LR_LOADMAP3DCOLORS	Procura a tabela de cores para a imagem e substitui os seguintes tons de cinza com a cor 3D correspondente:

	Cor	Substituído por
	DK Gray, RGB(128,128,128)	COLOR_3DSHADOW
	Cinza, RGB(192,192,192)	COLOR_3DFACE
	Lt cinza, RGB(223,223,223)	COLOR_3DLIGHT

LR_LOADTRANSPARENT	Recupera o valor de cor do primeiro pixel na imagem e substitui a entrada correspondente na tabela de cores com a cor de janela padrão (COLOR_WINDOW). Todos os pixels da imagem que usam essa entrada se tornar a cor de janela padrão. Esse valor se aplica somente a imagens que têm tabelas de cores correspondentes. Se fuLoad inclui valores a LR_LOADTRANSPARENT e o LR_LOADMAP3DCOLORS, o LRLOADTRANSPARENT tem precedência. No entanto, a entrada de tabela de cores é substituída com COLOR_3DFACE ao invés de COLOR_WINDOW.
LR_MONOCHROME	Carrega a imagem em preto e branco.
LR_SHARED	Compartilha o identificador de imagem se a imagem é carregada várias vezes. Se LR_SHARED não estiver definido, um segundo chamada LoadImage para o mesmo recurso irá carregar a imagem novamente e retornar um identificador diferente. Não use LR_SHARED para imagens que tenham tamanhos fora do padrão, que podem alterar após o carregamento, ou que são carregados de um arquivo. Windows 95 e Windows 98: A função localiza a primeira imagem com o nome de recurso solicitado no cache, independentemente do tamanho solicitado.
LR_VGACOLOR	Usa cores verdadeiras de VGA.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é o identificador da imagem recém-carregada.

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

Observações

Quando você tiver terminado usando o bitmap, cursor ou ícone, você pode liberar seu associado memória por chamado um das funções na tabela a seguir.

O sistema exclui automaticamente esses recursos quando termina o processo que criado-los, no entanto, chamado de apropriado função salva memória e diminui o tamanho do conjunto de trabalho do processo.

Windows CE: Os parâmetros cxDesired e cyDesired devem ser zero para IMAGE_BITMAP.

Windows CE não oferece suporte a alongamento e encolhimento dos ícones.

O parâmetro fuLoad deve ser zero (= = LR_DEFAULTCOLOR).

Se você tiver como alvo uma plataforma que não oferece suporte a cursores de mouse, você não pode especificar os valores SM_CXCURSOR e SM_CYCURSOR nos parâmetros cxDesired e cyDesired , e você não pode especificar IMAGE_CURSOR para o parâmetro uType.

Se você tiver como alvo uma plataforma que oferece suporte a cursores de mouse, você pode especificar SM_CXCURSOR e SM_CYCURSOR na cxDesired e cyDesired parâmetros e IMAGE_CURSOR no parâmetro uType.

QuickInfo

nbsp; Windows &NT: requer a versão 4.0 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.
Unicode:Implementado como versões Unicode e ANSI no Windows NT.

Ver também

Visão geral sobre recursos, recurso funciona, CopyImage, GetSystemMetrics, LoadBitmap, LoadCursor, LoadIcon

Index