Partilhar via


CAtlArray::SetCount

Chamar esse método para definir o tamanho do objeto de matriz.

bool SetCount( 
   size_t nNewSize, 
   int nGrowBy = - 1  
);

Parâmetros

  • nNewSize
    O tamanho da matriz necessário.

  • nGrowBy
    Um valor usado para determinar quão grande fazer o buffer. Um valor de -1 causa um valor calculado internamente a ser usado.

Valor de retorno

Retorna true se a matriz é redimensionada com êxito, falso caso contrário.

Comentários

A matriz pode ser gerada ou diminuído em tamanho. Se gerados, os elementos vazios extras são adicionados à matriz. Se diminuídos, os elementos com os índices os maiores serão excluídos e será liberada memória.

Use este método para definir o tamanho da matriz antes de usá-lo. Se SetCount não é usado, o processo de adicionar elementos — e a alocação de memória subseqüente executada — reduzirá a memória de desempenho e o fragmento.

Exemplo

Consulte o exemplo para CAtlArray::GetData.

Requisitos

Cabeçalho: atlcoll.h

Consulte também

Referência

Classe de CAtlArray