Classe CComSafeArrayBound
Essa classe é um wrapper para uma estrutura SAFEARRAYBOUND.
Sintaxe
class CComSafeArrayBound : public SAFEARRAYBOUND
Membros
Métodos
| Função | Descrição |
|---|---|
| CComSafeArrayBound | O construtor . |
| GetCount | Chame esse método para retornar o número de elementos. |
| GetLowerBound | Chame esse método para retornar o limite inferior. |
| GetUpperBound | Chame esse método para retornar o limite superior. |
| SetCount | Chame esse método para definir o número de elementos. |
| SetLowerBound | Chame esse método para definir o limite inferior. |
Operadores
| Operador | Descrição |
|---|---|
| operador = | Define o valor CComSafeArrayBound com um novo valor. |
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.