Classe CComSafeArrayBound

Esta aula é um wrapper para uma estrutura SAFEARRAYBOUND .

Sintaxe

class CComSafeArrayBound : public SAFEARRAYBOUND

Membros

Methods

Operadores

Observações

Esta classe é um wrapper para a SAFEARRAYBOUND estrutura usada pelo CComSafeArray. Fornece métodos para consultar e definir os limites superior e inferior de uma única dimensão de um CComSafeArray objeto e o número de elementos que ele contém. Um objeto multidimensional CComSafeArray utiliza um array de CComSafeArrayBound objetos, um para cada dimensão. Portanto, ao usar métodos como o GetCount, esteja ciente de que este método não devolverá o número total de elementos num array multidimensional.

Cabeçalho: atlsafe.h

Requerimentos

Cabeçalho: atlsafe.h

CComArraySafeBound::CComSafeArrayBound

O construtor.

CComSafeArrayBound(ULONG ulCount = 0, LONG lLowerBound = 0) throw();

Parâmetros

ulConde
O número de elementos na matriz.

lLowerBound
O limite inferior a partir do qual o array é numerado.

Observações

Se o array for acedido a partir de um programa C++, recomenda-se que o limite inferior seja definido como 0. Pode ser preferível usar um valor inferior diferente se o array for usado com outras linguagens, como o Visual Basic.

CComSafeArrayBound::GetCount

Chame este método para devolver o número de elementos.

ULONG GetCount() const throw();

Valor de retorno

Devolve o número de elementos.

Observações

Se o objeto associado CComSafeArray representar um array multidimensional, este método só devolverá o número total de elementos na dimensão mais à direita. Use CComSafeArray::GetCount para obter o número total de elementos.

CComSafeArrayBound::GetLowerBound

Chame este método para devolver o limite inferior.

LONG GetLowerBound() const throw();

Valor de retorno

Devolve o limite inferior do CComSafeArrayBound objeto.

CComSafeArrayBound::GetUpperBound

Chame este método para devolver o limite superior.

LONG GetUpperBound() const throw();

Valor de retorno

Devolve o limite superior do CComSafeArrayBound objeto.

Observações

O limite superior depende do número de elementos e do valor do limite inferior. Por exemplo, se o limite inferior for 0 e o número de elementos for 10, o limite superior será automaticamente definido para 9.

CComSafeArrayBound::operator =

Define o CComSafeArrayBound para um novo valor.

CComSafeArrayBound& operator= (const CComSafeArrayBound& bound) throw();
CComSafeArrayBound& operator= (ULONG ulCount) throw();

Parâmetros

Ligado
Um objeto CComSafeArrayBound.

ulConde
O número de elementos.

Valor de retorno

Devolve um ponteiro para o CComSafeArrayBound objeto.

Observações

O CComSafeArrayBound objeto pode ser atribuído usando um existente CComSafeArrayBound, ou fornecendo o número de elementos, caso em que o limite inferior é definido para 0 por defeito.

CComSafeArrayBound::SetCount

Chame este método para definir o número de elementos.

ULONG SetCount(ULONG ulCount) throw();

Parâmetros

ulConde
O número de elementos.

Valor de retorno

Devolve o número de elementos no CComSafeArrayBound objeto.

CComSafeArrayBound::SetLowerBound

Chame este método para definir o limite inferior.

LONG SetLowerBound(LONG lLowerBound) throw();

Parâmetros

lLowerBound
O limite inferior.

Valor de retorno

Devolve o novo limite inferior do CComSafeArrayBound objeto.

Observações

Se o array for acedido a partir de um programa Visual C++, recomenda-se que o limite inferior seja definido como 0. Pode ser preferível usar um valor inferior diferente se o array for usado com outras linguagens, como o Visual Basic.

O limite superior depende do número de elementos e do valor do limite inferior. Por exemplo, se o limite inferior for 0 e o número de elementos for 10, o limite superior será automaticamente definido para 9.

Consulte também

Visão geral da classe