Partilhar via


CObArray::SetAt

Define o elemento de matriz no índice especificado.

void SetAt(
   INT_PTR nIndex,
   CObject* newElement 
);

Parâmetros

  • nIndex
    Um índice inteiro que é maior ou igual a 0 e menor ou igual ao valor retornado por GetUpperBound.

  • newElement
    O ponteiro do objeto a ser inserido em esta matriz.Um valor de NULO é permitido.

Comentários

SetAt não fará com que a matriz aumenta.Use SetAtGrow se você desejar que a matriz aumentarem automaticamente.

Você deve garantir que o valor de índice representa uma posição válido na matriz.Se está fora dos limites, então a versão de depuração de biblioteca afirma.

A tabela a seguir mostra outras funções de membro que são semelhantes a CObArray::SetAt.

Classe

Função de membro

CByteArray

void SetAt( INT_PTRnIndex, BYTE newElement );

CDWordArray

void SetAt( INT_PTRnIndex, DWORD newElement );

CPtrArray

void SetAt( INT_PTRnIndex, void* newElement );

CStringArray

void SetAt( INT_PTRnIndex, LPCTSTR newElement );

CUIntArray

void SetAt( INT_PTRnIndex, UINT newElement );

CWordArray

void SetAt( INT_PTRnIndex, WORD newElement );

Exemplo

Consulte CObList::CObList para uma listagem da classe de CAge usada em todos os exemplos de coleção.

CObArray arr;
CObject* pa;

arr.Add(new CAge(21)); // Element 0
arr.Add(new CAge(40)); // Element 1
if ((pa = arr.GetAt(0)) != NULL)
{
   arr.SetAt(0, new CAge(30));  // Replace element 0.
   delete pa; // Delete the original element at 0.
}
#ifdef _DEBUG
   afxDump.SetDepth(1);
   afxDump << _T("SetAt example: ") << &arr << _T("\n");
#endif      

Os resultados do programa é a seguinte:

SetAt example: A CObArray with 2 elements

[0] = a CAge at $47E0 30

[1] = a CAge at $47A0 40

Requisitos

Cabeçalho: afxcoll.h

Consulte também

Referência

Classe de CObArray

Gráfico de hierarquia

CObArray::GetAt

CObArray::SetAtGrow

CObArray::ElementAt

CObArray::operator [ ]