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.

Recurso Função de lançamento
Bitmap ExcluirObjeto
Cursor DestroyCursor
Ícone DestroyIcon

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