Compartilhar via


Função LoadIconWithScaleDown (commctrl.h)

Carrega um ícone. Se o ícone não for um tamanho padrão, essa função reduzirá verticalmente uma imagem maior em vez de escalar verticalmente uma imagem menor.

Sintaxe

HRESULT LoadIconWithScaleDown(
  [in]  HINSTANCE hinst,
  [in]  PCWSTR    pszName,
  [in]  int       cx,
  [in]  int       cy,
  [out] HICON     *phico
);

Parâmetros

[in] hinst

Tipo: HINSTANCE

Um identificador para o módulo de um arquivo DLL ou executável (.exe) que contém o ícone a ser carregado. Para obter mais informações, consulte GetModuleHandle.

Para carregar um ícone de sistema predefinido ou um arquivo de ícone autônomo, defina esse parâmetro como NULL.

[in] pszName

Tipo: PCWSTR

Um ponteiro para um buffer Unicode encerrado em nulo que contém informações de localização sobre o ícone a ser carregado.

Se hinst não for NULL, pszName especificará o recurso de ícone por nome ou ordinal. Esse ordinal deve ser empacotado usando a macro MAKEINTRESOURCE .

Se hinst for NULL, pszName especificará o identificador (começando com o prefixo IDI_) de um ícone de sistema predefinido a ser carregado.

[in] cx

Tipo: int

A largura desejada, em pixels, do ícone.

[in] cy

Tipo: int

A altura desejada, em pixels, do ícone.

[out] phico

Tipo: HICON*

Quando essa função retorna, contém um ponteiro para o identificador do ícone carregado.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro, incluindo o seguinte:

Código de retorno Descrição
E_INVALIDARG
O conteúdo do buffer apontado por pszName não se encaixa em nenhuma das interpretações esperadas.

Comentários

Essa função primeiro pesquisará no arquivo de ícone um ícone com exatamente o mesmo tamanho. Se uma correspondência não for encontrada, a menos que cx e cy correspondam a um dos tamanhos de ícone padrão— 16, 32, 48 ou 256 pixels, o próximo ícone maior será selecionado e, em seguida, reduzido para o tamanho desejado. Por exemplo, se um ícone com uma dimensão x de 40 pixels for solicitado pelo aplicativo de sinal de chamada, o ícone de 48 pixels será usado e reduzido para 40 pixels. Por outro lado, a função LoadImage seleciona o ícone de 32 pixels e escala-o até 40 pixels.

Se a função não conseguir localizar um ícone maior, ela usará como padrão o comportamento padrão de localizar o próximo ícone menor e dimensioná-lo até o tamanho desejado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho commctrl.h
Biblioteca Comctl32.lib
DLL Comctl32.dll