Класс CComSafeArrayBound
Этот класс представляет собой оболочку для структуры SAFEARRAYBOUND .
Синтаксис
class CComSafeArrayBound : public SAFEARRAYBOUND
Участники
Методы
| Function | Description |
|---|---|
| CComSafeArrayBound | Конструктор. |
| GetCount | Вызовите этот метод, чтобы вернуть количество элементов. |
| GetLowerBound | Вызовите этот метод для возврата нижней границы. |
| GetUpperBound | Вызовите этот метод, чтобы вернуть верхнюю границу. |
| SetCount | Вызовите этот метод, чтобы задать количество элементов. |
| SetLowerBound | Вызовите этот метод, чтобы задать нижнюю границу. |
Операторы
| Operator | Description |
|---|---|
| оператор = | CComSafeArrayBound Задает новое значение. |
Замечания
Этот класс представляет собой оболочку для структуры, используемой SAFEARRAYBOUND CComSafeArray. Он предоставляет методы для запроса и задания верхних и нижних границ одного измерения CComSafeArray объекта и количества элементов, содержащихся в нем. Многомерный CComSafeArray объект использует массив CComSafeArrayBound объектов, по одному для каждого измерения. Поэтому при использовании таких методов, как GetCount, следует помнить, что этот метод не вернет общее количество элементов в многомерном массиве.
Заголовок: atlsafe.h
Требования
Заголовок: atlsafe.h
CComSafeArrayBound::CComSafeArrayBound
Конструктор.
CComSafeArrayBound(ULONG ulCount = 0, LONG lLowerBound = 0) throw();
Параметры
ulCount
Количество элементов в массиве.
lLowerBound
Нижняя граница, из которой нумерован массив.
Замечания
Если к массиву требуется доступ из программы C++, рекомендуется определить нижнюю границу как 0. Возможно, рекомендуется использовать другое нижнее значение, если массив будет использоваться с другими языками, например Visual Basic.
CComSafeArrayBound::GetCount
Вызовите этот метод, чтобы вернуть количество элементов.
ULONG GetCount() const throw();
Возвращаемое значение
Возвращает количество элементов.
Замечания
Если связанный CComSafeArray объект представляет многомерный массив, этот метод возвращает только общее количество элементов в самом правом измерении. Используйте CComSafeArray::GetCount , чтобы получить общее количество элементов.
CComSafeArrayBound::GetLowerBound
Вызовите этот метод для возврата нижней границы.
LONG GetLowerBound() const throw();
Возвращаемое значение
Возвращает нижнюю границу CComSafeArrayBound объекта.
CComSafeArrayBound::GetUpperBound
Вызовите этот метод, чтобы вернуть верхнюю границу.
LONG GetUpperBound() const throw();
Возвращаемое значение
Возвращает верхнюю границу CComSafeArrayBound объекта.
Замечания
Верхняя граница зависит от количества элементов и нижней границы. Например, если нижняя граница равно 0, а число элементов равно 10, верхняя граница автоматически будет иметь значение 9.
CComSafeArrayBound::operator =
CComSafeArrayBound Задает новое значение.
CComSafeArrayBound& operator= (const CComSafeArrayBound& bound) throw();
CComSafeArrayBound& operator= (ULONG ulCount) throw();
Параметры
ограничивать
Объект CComSafeArrayBound.
ulCount
Число элементов.
Возвращаемое значение
Возвращает указатель на CComSafeArrayBound объект.
Замечания
Объект CComSafeArrayBound можно назначить с помощью существующего CComSafeArrayBoundили указать количество элементов, в этом случае нижняя граница имеет значение 0 по умолчанию.
CComSafeArrayBound::SetCount
Вызовите этот метод, чтобы задать количество элементов.
ULONG SetCount(ULONG ulCount) throw();
Параметры
ulCount
Число элементов.
Возвращаемое значение
Возвращает количество элементов в объекте CComSafeArrayBound .
CComSafeArrayBound::SetLowerBound
Вызовите этот метод, чтобы задать нижнюю границу.
LONG SetLowerBound(LONG lLowerBound) throw();
Параметры
lLowerBound
Нижняя граница.
Возвращаемое значение
Возвращает новую нижнюю границу CComSafeArrayBound объекта.
Замечания
Если доступ к массиву требуется получить из программы Visual C++, рекомендуется определить нижнюю границу как 0. Возможно, рекомендуется использовать другое нижнее значение, если массив будет использоваться с другими языками, например Visual Basic.
Верхняя граница зависит от количества элементов и нижней границы. Например, если нижняя граница равно 0, а число элементов равно 10, верхняя граница автоматически будет иметь значение 9.