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.

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

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