Classe COleSafeArray

Artigo
06/10/2015

Uma classe para trabalhar com matrizes do tipo e de dimensão arbitrários.

class COleSafeArray : public tagVARIANT

Membros

Construtores public

Nome	Descrição
COleSafeArray::COleSafeArray	Constrói um objeto de COleSafeArray .

Métodos públicos

Nome	Descrição
COleSafeArray::AccessData	Recupera um ponteiro para os dados de matriz.
COleSafeArray::AllocData	Aloca memória para a matriz.
COleSafeArray::AllocDescriptor	Aloca memória para o descritor de matriz seguro.
COleSafeArray::Attach	Fornece o controle da matriz existente de VARIANT ao objeto de COleSafeArray .
COleSafeArray::Clear	Libera todos os dados em VARIANTsubjacente.
COleSafeArray::Copy	Cria uma cópia de uma matriz existente.
COleSafeArray::Create	Cria uma matriz segura.
COleSafeArray::CreateOneDim	Cria um objeto unidimensional de COleSafeArray .
COleSafeArray::Destroy	For uma matriz existente.
COleSafeArray::DestroyData	Destrói dados em uma matriz segura.
COleSafeArray::DestroyDescriptor	For um descritor de matriz segura.
COleSafeArray::Detach	Dispara a matriz de VARIANT do objeto de COleSafeArray (para que os dados não serão liberados.)
COleSafeArray::GetByteArray	Copia o conteúdo da matriz segura em CByteArray.
COleSafeArray::GetDim	Retorna o número de dimensões na matriz.
COleSafeArray::GetElement	Recupera um elemento de matriz segura.
COleSafeArray::GetElemSize	Retorna o tamanho, em bytes, de um elemento em uma matriz segura.
COleSafeArray::GetLBound	Retorna o limite inferior para qualquer dimensão da matriz segura.
COleSafeArray::GetOneDimSize	Retorna o número de elementos no objeto unidimensional de COleSafeArray .
COleSafeArray::GetUBound	Retorna o limite superior para qualquer dimensão da matriz segura.
COleSafeArray::Lock	Sai a contagem de bloqueio de uma matriz e coloca um ponteiro para os dados de matriz no descritor de matriz.
COleSafeArray::PtrOfIndex	Retorna um ponteiro para o elemento indexado.
COleSafeArray::PutElement	Atribui um único elemento na matriz.
COleSafeArray::Redim	Altera o limite (mais à direita) o menos segura significativo de uma matriz.
COleSafeArray::ResizeOneDim	Altera o número de elementos em um objeto unidimensional de COleSafeArray .
COleSafeArray::UnaccessData	Diminui a contagem de bloqueio de uma matriz e invalida o ponteiro recuperados por AccessData.
COleSafeArray::Unlock	Diminui a contagem de bloqueio de uma matriz para que ele possa ser liberada ou redimensionado.

Operadores públicos

Nome	Descrição
COleSafeArray::operator LPCVARIANT	Acessa a estrutura subjacente de VARIANT do objeto de COleSafeArray .
COleSafeArray::operator LPVARIANT	Acessa a estrutura subjacente de VARIANT do objeto de COleSafeArray .
COleSafeArray::operator =	Valores das cópias em um objeto de COleSafeArray (SAFEARRAY, VARIANT, COleVariant, ou matriz de COleSafeArray ).
COleSafeArray::operator = =	Compara duas matrizes variantes (SAFEARRAY, VARIANT, COleVariant, ou arrays de COleSafeArray ).
COleSafeArray::operator <<	Saída que o conteúdo de COleSafeArray objeto para o contexto do despejo.

Comentários

COleSafeArray deriva da estrutura de VARIANT OLE. As funções de membro do OLE SAFEARRAY estão disponíveis através de COleSafeArray, bem como um conjunto de funções de membro especificamente projetadas para arrays unidimensionais de bytes.