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);
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.
Valor | Significado |
---|---|
IMAGE_BITMAP | Carrega um bitmap. |
IMAGE_CURSOR | Carrega um cursor. |
IMAGE_ICON | Carrega um ícone. |
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. |
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.
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.
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.
Visão geral sobre recursos, recurso funciona, CopyImage, GetSystemMetrics, LoadBitmap, LoadCursor, LoadIcon