Compartilhar via


Método IImageList::SetImageCount (commoncontrols.h)

Redimensiona uma lista de imagens existente.

Sintaxe

HRESULT SetImageCount(
  [in] UINT uNewCount
);

Parâmetros

[in] uNewCount

Tipo: UINT

Um valor que especifica o novo tamanho da lista de imagens.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Se um aplicativo expandir uma lista de imagens usando esse método, ele deverá adicionar novas imagens usando IImageList::Replace. Se o aplicativo não adicionar imagens válidas aos novos índices, as operações de desenho que usam os novos índices serão imprevisíveis.

Se você diminuir o tamanho de uma lista de imagens usando esse método, as imagens no final da lista para as quais não há mais espaço serão truncadas da lista. As imagens truncadas dessa maneira são desalocadas automaticamente.

Para usar IImageList::SetImageCount, especifique Comctl32.dll versão 6 no manifesto. Para obter mais informações sobre manifestos, consulte Habilitando estilos visuais.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho commoncontrols.h
DLL Comctl32.dll (versão 6.0 ou posterior)