Classe CComSafeArrayBound

Essa classe é um wrapper para uma estrutura SAFEARRAYBOUND.

Sintaxe

class CComSafeArrayBound : public SAFEARRAYBOUND

Membros

Métodos

Operadores

Comentários

Essa classe é um wrapper para a estrutura SAFEARRAYBOUND usada por CComSafeArray. Ele fornece métodos para consultar e definir os limites superior e inferior de uma única dimensão de um objeto CComSafeArray e o número de elementos que ele contém. Um objeto CComSafeArray multidimensional usa uma matriz de objetos CComSafeArrayBound, uma para cada dimensão. Portanto, ao usar métodos como GetCount, lembre-se de que esse método não retornará o número total de elementos em uma matriz multidimensional.

Header: atlsafe.h

Requisitos

Header: atlsafe.h

CComSafeArrayBound::CComSafeArrayBound

O construtor .

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

Parâmetros

ulCount
O número de elementos na matriz.

lLowerBound
O limite inferior a partir do qual a matriz está numerada.

Comentários

Se a matriz for acessada de um programa C++, é recomendável que o limite inferior seja definido como 0. Pode ser preferível usar um valor de limite inferior diferente se a matriz for usada com outras linguagens, como o Visual Basic.

CComSafeArrayBound::GetCount

Chame esse método para retornar o número de elementos.

ULONG GetCount() const throw();

Valor de retorno

Retorna o número de elementos.

Comentários

Se o objeto CComSafeArray associado representar uma matriz multidimensional, esse método retornará apenas 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 esse método para retornar o limite inferior.

LONG GetLowerBound() const throw();

Valor de retorno

Retorna o limite inferior do objeto CComSafeArrayBound.

CComSafeArrayBound::GetUpperBound

Chame esse método para retornar o limite superior.

LONG GetUpperBound() const throw();

Valor de retorno

Retorna o limite superior do objeto CComSafeArrayBound.

Comentários

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 como 9.

CComSafeArrayBound::operator =

Define o valor CComSafeArrayBound com um novo valor.

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

Parâmetros

bound
Um objeto CComSafeArrayBound.

ulCount
O número de elementos.

Valor de retorno

Retorna um ponteiro para o objeto CComSafeArrayBound.

Comentários

O objeto CComSafeArrayBound pode ser atribuído usando um CComSafeArrayBound existente ou fornecendo o número de elementos, nesse caso, o limite inferior é definido como 0 por padrão.

CComSafeArrayBound::SetCount

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

ULONG SetCount(ULONG ulCount) throw();

Parâmetros

ulCount
O número de elementos.

Valor de retorno

Retorna o número de elementos no CComSafeArrayBound.

CComSafeArrayBound::SetLowerBound

Chame esse método para definir o limite inferior.

LONG SetLowerBound(LONG lLowerBound) throw();

Parâmetros

lLowerBound
O limite inferior.

Valor de retorno

Retorna o novo limite inferior do objeto CComSafeArrayBound.

Comentários

Se a matriz for acessada de um programa do Visual C++, é recomendável que o limite inferior seja definido como 0. Pode ser preferível usar um valor de limite inferior diferente se a matriz for usada 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 como 9.

Confira também

Visão geral da aula