LoadImage

9/9/2008

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

Syntax

HANDLE LoadImage(
  HINSTANCE hinst,
  LPCTSTR lpszName, 
  UINT uType, 
  int cxDesired,
  int cyDesired,
  UINT fuLoad 
);

Parameters

• hinst
  [no] Identificador para uma instância do módulo que contém a imagem a ser carregado.

• lpszName
  [no] Ponteiro para uma seqüência de caracteres NULL-Terminated que contém o nome do recurso de imagem na hinst módulo que identifica a imagem para carregar.

• uType
  [no] Especifica o tipo de imagem a ser carregado. Este parâmetro pode ser uma dos seguinte valores.

  Valor	Descrição
  IMAGE_BITMAP	Carrega um bitmap.
  IMAGE_CURSOR	Carrega um cursor.
  IMAGE_ICON	Carrega um ícone.

• cxDesired
  [no] Especifica a largura, em pixels, o ícone de cursor. Se este parâmetro for zero, a função usa o valor métrico sistema SM_CXICON ou SM_CXCURSOR para definir a largura. Se uType é IMAGE_BITMAP, este parâmetro deve ser zero.

• cyDesired
  [no] Especifica a altura, em pixels, o ícone de cursor. Se este parâmetro for zero, a função usa o valor métrico sistema SM_CYICON ou SM_CYCURSOR para definir a altura. Se uType é IMAGE_BITMAP, este parâmetro deve ser zero.

• fuLoad
  [no] Definido como zero.

  Windows Embedded CE se comporta como se os valores LR_DEFAULTCOLOR e LR_DEFAULTSIZE são definidos. LR_DEFAULTCOLOR não significa monocromático. LR_DEFAULTSIZE significa que o sistema usa a largura ou altura especificado pelos valores sistema métrico para cursores ou ícones se a cxDesired Ou cyDesired valores estão definidos como zero. Se o recurso contém múltiplo imagens, a função usa o tamanho da primeira imagem.

Return Value

O identificador da imagem recém-carregada indica sucesso. NULL Indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

Quando tiver terminado de usar um bitmap, cursor ou ícone é carregado, você poderá versão seu associado memória por chamado um das funções na seguinte tabela.

Recurso	Liberar função
Bitmap	ExcluirObjeto
Cursor	DestroyCursor
Ícone	DestroyIcon

Exclui automaticamente o sistema esses recursos quando o processo que criou termina; No entanto, chamado de apropriado função salva memória e diminui o tamanho da conjunto de trabalho do processo.

Se você tiver como alvo uma plataforma que faz não mouse suporte cursores, não é possível especificar a SM_CXCURSOR e SM_CYCURSOR valores na cxDesired e cyDesired Parâmetros e você não pode especificar IMAGE_CURSOR para a uType parâmetro.

Você geralmente usado LoadImage Bitmaps de um padrão, Cursores e Ícones carregar arquivo recurso (.rc). Também é possível, no entanto, para armazenar esses recursos em um comum arquivo DLL. Para obter um identificador para um recurso armazenado em um DLL, chamar o LoadLibraryEx função com o dwFlags parâmetro definido como LOAD_LIBRARY_AS_DATAFILE. Em seguida, você pode transmitir o identificador resultante para LoadImage.

Os bitmaps retornado da LoadImage não é gravável. Todas as chamadas para gravar um bitmap retornado pelo LoadImage função falhará.

Requirements

Header	winuser.h
Library	Loadimg.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

DeleteObject
DestroyCursor
DestroyIcon
GetSystemMetrics
LoadBitmap
LoadIcon

Other Resources

LoadLibraryEx