Класс CComSafeArrayBound

Этот класс представляет собой оболочку для структуры SAFEARRAYBOUND .

Синтаксис

class CComSafeArrayBound : public SAFEARRAYBOUND

Участники

Методы

Function	Description
CCom Сейф ArrayBound	Конструктор.
GetCount	Вызовите этот метод, чтобы вернуть количество элементов.
GetLowerBound	Вызовите этот метод для возврата нижней границы.
Getupperbound	Вызовите этот метод, чтобы вернуть верхнюю границу.
SetCount	Вызовите этот метод, чтобы задать количество элементов.
SetLowerBound	Вызовите этот метод, чтобы задать нижнюю границу.

Операторы

Operator	Description
оператор =	CComSafeArrayBound Задает новое значение.

Замечания

Этот класс представляет собой оболочку для структуры, используемой SAFEARRAYBOUNDCCom Сейф Array. Он предоставляет методы для запроса и задания верхних и нижних границ одного измерения CComSafeArray объекта и количества элементов, содержащихся в нем. Многомерный CComSafeArray объект использует массив CComSafeArrayBound объектов, по одному для каждого измерения. Поэтому при использовании таких методов, как GetCount, следует помнить, что этот метод не вернет общее количество элементов в многомерном массиве.

Заголовок: atlsafe.h

Требования

Заголовок: atlsafe.h

CCom Сейф ArrayBound::CCom Сейф ArrayBound

Конструктор.

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

Параметры

ulCount
Количество элементов в массиве.

lLowerBound
Нижняя граница, из которой нумерован массив.

Замечания

Если к массиву требуется доступ из программы C++, рекомендуется определить нижнюю границу как 0. Возможно, рекомендуется использовать другое нижнее значение, если массив будет использоваться с другими языками, например Visual Basic.

CCom Сейф ArrayBound::GetCount

Вызовите этот метод, чтобы вернуть количество элементов.

ULONG GetCount() const throw();

Возвращаемое значение

Возвращает количество элементов.

Замечания

Если связанный CComSafeArray объект представляет многомерный массив, этот метод возвращает только общее количество элементов в самом правом измерении. Используйте CCom Сейф Array::GetCount, чтобы получить общее количество элементов.

CCom Сейф ArrayBound::GetLowerBound

Вызовите этот метод для возврата нижней границы.

LONG GetLowerBound() const throw();

Возвращаемое значение

Возвращает нижнюю границу CComSafeArrayBound объекта.

CCom Сейф ArrayBound::GetUpperBound

Вызовите этот метод, чтобы вернуть верхнюю границу.

LONG GetUpperBound() const throw();

Возвращаемое значение

Возвращает верхнюю границу CComSafeArrayBound объекта.

Замечания

Верхняя граница зависит от количества элементов и нижней границы. Например, если нижняя граница равно 0, а число элементов равно 10, верхняя граница автоматически будет иметь значение 9.

CCom Сейф ArrayBound::operator =

CComSafeArrayBound Задает новое значение.

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

Параметры

Связаны
Объект CComSafeArrayBound.

ulCount
Число элементов.

Возвращаемое значение

Возвращает указатель на CComSafeArrayBound объект.

Замечания

Объект CComSafeArrayBound можно назначить с помощью существующего CComSafeArrayBoundили указать количество элементов, в этом случае нижняя граница имеет значение 0 по умолчанию.

CCom Сейф ArrayBound::SetCount

Вызовите этот метод, чтобы задать количество элементов.

ULONG SetCount(ULONG ulCount) throw();

Параметры

ulCount
Число элементов.

Возвращаемое значение

Возвращает количество элементов в объекте CComSafeArrayBound .

CCom Сейф ArrayBound::SetLowerBound

Вызовите этот метод, чтобы задать нижнюю границу.

LONG SetLowerBound(LONG lLowerBound) throw();

Параметры

lLowerBound
Нижняя граница.

Возвращаемое значение

Возвращает новую нижнюю границу CComSafeArrayBound объекта.

Замечания

Если доступ к массиву требуется получить из программы Visual C++, рекомендуется определить нижнюю границу как 0. Возможно, рекомендуется использовать другое нижнее значение, если массив будет использоваться с другими языками, например Visual Basic.

Верхняя граница зависит от количества элементов и нижней границы. Например, если нижняя граница равно 0, а число элементов равно 10, верхняя граница автоматически будет иметь значение 9.

См. также

Общие сведения о классе