CopyImage

A função CopyImage cria uma nova imagem (ícone, cursor ou bitmap) e copia os atributos da imagem especificada para o novo. Se necessário, a função expande os bits para ajustar o tamanho desejado da nova imagem.

Alça CopyImage ( Lidar com  hImage, / / manipular a imagem para copiarUINTuType, / / tipo de imagens para copiarintcxDesired, / / desejado largura da nova imagemintcyDesired, / / desejado altura da nova imagemUINTfuFlags / / copiar sinalizadores);
 

Parâmetros

hinst

Identificador para uma instância do módulo que contém a imagem a ser copiada.

uType

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

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

cxDesired

Especifica a largura desejada, em pixels, da imagem.

cyDesired

Especifica a altura desejada, em pixels, da imagem.

fuFlags

Especifica uma combinação do seguinte valores:

Valor	Significado
LR_COPYDELETEORG	Exclui a imagem original após a criação da cópia.
LR_COPYRETURNORG	Cria uma cópia exata da imagem, ignorando os parâmetros cxDesired e cyDesired.
LR_MONOCHROME	Cria uma nova imagem monocromática.
LR_COPYFROMRESOURCE	Tenta recarregar um recurso de ícone ou cursor do arquivo de recurso original em vez de simplesmente copiando a imagem atual. Isso é útil para criar uma cópia de tamanhos diferentes quando o arquivo de recurso contém vários tamanhos do recurso. Sem esse Sinalizar, CopyImage alonga a imagem original para o novo tamanho. Se este sinalizador estiver definido, CopyImage usa o tamanho no arquivo de recurso mais próximo para o tamanho desejado. Isso funcionará somente se hImage foi carregado pela LoadIcon ou LoadCursorou LoadImage com o sinalizador LR_SHARED.

Retornar valores

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

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

Observações

Quando tiver terminado de usar o recurso, você pode liberar seu associado memória por chamado um das funções na tabela a seguir.

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

QuickInfo

nbsp; Windows &NT: requer a versão 3.5 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.

Ver também

Visão geral sobre recursos, funções de recurso, LoadImage

Index