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
El 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.