CComSafeArrayBound (clase)

Esta clase es un contenedor de una estructura SAFEARRAYBOUND.

Sintaxis

class CComSafeArrayBound : public SAFEARRAYBOUND

Miembros

Métodos

Función	Descripción
CComSafeArrayBound	Constructor .
GetCount	Llame a este método para devolver el número de elementos.
GetLowerBound	Llame a este método para devolver el límite inferior.
GetUpperBound	Llame a este método para devolver el límite superior.
SetCount	Llame a este método para establecer el número de elementos.
SetLowerBound	Llame a este método para establecer el límite inferior.

Operadores

Operador	Descripción
operator =	Establece CComSafeArrayBound en un nuevo valor.

Comentarios

Esta clase es un contenedor de la estructura SAFEARRAYBOUND usada por CComSafeArray. Proporciona métodos para consultar y establecer los límites superior e inferior de una sola dimensión de un objeto CComSafeArray y el número de elementos que contiene. Un objeto CComSafeArray multidimensional usa una matriz de objetos CComSafeArrayBound, uno para cada dimensión. Por lo tanto, al usar métodos como GetCount, tenga en cuenta que este método no devolverá el número total de elementos de una matriz multidimensional.

Encabezado: atlsafe.h

Requisitos

Encabezado: atlsafe.h

CComSafeArrayBound::CComSafeArrayBound

Constructor .

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

Parámetros

ulCount
Número de elementos de la matriz.

lLowerBound
Límite inferior desde el que se numera la matriz.

Comentarios

Si se va a acceder a la matriz desde un programa de C++, se recomienda definir el límite inferior como 0. Puede ser preferible usar un valor de límite inferior diferente si la matriz se va a usar con otros lenguajes, como Visual Basic.

CComSafeArrayBound::GetCount

Llame a este método para devolver el número de elementos.

ULONG GetCount() const throw();

Valor devuelto

Devuelve el número de elementos.

Comentarios

Si el objeto CComSafeArray asociado representa una matriz multidimensional, este método solo devolverá el número total de elementos de la dimensión situada más a la derecha. Use CComSafeArray::GetCount para obtener el número total de elementos.

CComSafeArrayBound::GetLowerBound

Llame a este método para devolver el límite inferior.

LONG GetLowerBound() const throw();

Valor devuelto

Devuelve el límite inferior del objeto CComSafeArrayBound.

CComSafeArrayBound::GetUpperBound

Llame a este método para devolver el límite superior.

LONG GetUpperBound() const throw();

Valor devuelto

Devuelve el límite superior del objeto CComSafeArrayBound.

Comentarios

El límite superior depende del número de elementos y del valor de límite inferior. Por ejemplo, si el límite inferior es 0 y el número de elementos es 10, el límite superior se establecerá automáticamente en 9.

CComSafeArrayBound::operator =

Establece CComSafeArrayBound en un nuevo valor.

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

Parámetros

bound
Un objeto CComSafeArrayBound.

ulCount
Número de elementos.

Valor devuelto

Devuelve un puntero al objeto CComSafeArrayBound.

Comentarios

El objeto CComSafeArrayBound se puede asignar mediante una clase CComSafeArrayBound existente o proporcionando el número de elementos, en cuyo caso el límite inferior se establece en 0 de forma predeterminada.

CComSafeArrayBound::SetCount

Llame a este método para establecer el número de elementos.

ULONG SetCount(ULONG ulCount) throw();

Parámetros

ulCount
Número de elementos.

Valor devuelto

Devuelve el número de elementos del objeto CComSafeArrayBound.

CComSafeArrayBound::SetLowerBound

Llame a este método para establecer el límite inferior.

LONG SetLowerBound(LONG lLowerBound) throw();

Parámetros

lLowerBound
Límite inferior.

Valor devuelto

Devuelve el nuevo límite inferior del objeto CComSafeArrayBound.

Comentarios

Si se va a acceder a la matriz desde un programa de Visual C++, se recomienda definir el límite inferior como 0. Puede ser preferible usar un valor de límite inferior diferente si la matriz se va a usar con otros lenguajes, como Visual Basic.

El límite superior depende del número de elementos y del valor de límite inferior. Por ejemplo, si el límite inferior es 0 y el número de elementos es 10, el límite superior se establecerá automáticamente en 9.

Consulte también

Información general sobre la clase