Klasa CComSafeArrayBound

Ta klasa jest otoką struktury SAFEARRAYBOUND .

Składnia

class CComSafeArrayBound : public SAFEARRAYBOUND

Elementy członkowskie

Metody

Operatory

Uwagi

Ta klasa jest otoką struktury używanej SAFEARRAYBOUND przez CComSafeArray. Udostępnia metody wykonywania zapytań i ustawiania górnych i dolnych granic pojedynczego CComSafeArray wymiaru obiektu oraz liczby elementów, które zawiera. Obiekt wielowymiarowy CComSafeArray używa tablicy CComSafeArrayBound obiektów , po jednym dla każdego wymiaru. W związku z tym w przypadku używania metod takich jak GetCount należy pamiętać, że ta metoda nie zwróci całkowitej liczby elementów w tablicy wielowymiarowej.

Nagłówek: atlsafe.h

Wymagania

Nagłówek: atlsafe.h

CComSafeArrayBound::CComSafeArrayBound

Konstruktor.

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

Parametry

ulCount
Liczba elementów w tablicy.

lLowerBound
Dolna granica, z której tablica jest numerowana.

Uwagi

Jeśli do tablicy ma być uzyskiwany dostęp z programu C++, zaleca się zdefiniowanie dolnej granicy jako 0. Preferowane może być użycie innej niższej wartości powiązanej, jeśli tablica ma być używana z innymi językami, takimi jak Visual Basic.

CComSafeArrayBound::GetCount

Wywołaj tę metodę, aby zwrócić liczbę elementów.

ULONG GetCount() const throw();

Wartość zwracana

Zwraca liczbę elementów.

Uwagi

Jeśli skojarzony CComSafeArray obiekt reprezentuje tablicę wielowymiarową, ta metoda zwróci tylko całkowitą liczbę elementów w najbardziej prawym wymiarze. Użyj CComSafeArray::GetCount , aby uzyskać całkowitą liczbę elementów.

CComSafeArrayBound::GetLowerBound

Wywołaj tę metodę, aby zwrócić dolną granicę.

LONG GetLowerBound() const throw();

Wartość zwracana

Zwraca dolną granicę CComSafeArrayBound obiektu.

CComSafeArrayBound::GetUpperBound

Wywołaj tę metodę, aby zwrócić górną granicę.

LONG GetUpperBound() const throw();

Wartość zwracana

Zwraca górną granicę CComSafeArrayBound obiektu.

Uwagi

Górna granica zależy od liczby elementów i dolnej wartości powiązanej. Jeśli na przykład dolna granica wynosi 0, a liczba elementów to 10, górna granica zostanie automatycznie ustawiona na 9.

CComSafeArrayBound::operator =

CComSafeArrayBound Ustawia wartość na nową.

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

Parametry

granica
Obiekt CComSafeArrayBound.

ulCount
Liczba elementów.

Wartość zwracana

Zwraca wskaźnik do CComSafeArrayBound obiektu.

Uwagi

Obiekt CComSafeArrayBound można przypisać przy użyciu istniejącego CComSafeArrayBoundobiektu lub podając liczbę elementów, w tym przypadku dolna granica jest domyślnie ustawiona na 0.

CComSafeArrayBound::SetCount

Wywołaj tę metodę, aby ustawić liczbę elementów.

ULONG SetCount(ULONG ulCount) throw();

Parametry

ulCount
Liczba elementów.

Wartość zwracana

Zwraca liczbę elementów w CComSafeArrayBound obiekcie.

CComSafeArrayBound::SetLowerBound

Wywołaj tę metodę, aby ustawić dolną granicę.

LONG SetLowerBound(LONG lLowerBound) throw();

Parametry

lLowerBound
Dolna granica.

Wartość zwracana

Zwraca nową dolną granicę CComSafeArrayBound obiektu.

Uwagi

Jeśli dostęp do tablicy ma być uzyskiwany z programu Visual C++, zaleca się zdefiniowanie dolnej granicy jako 0. Preferowane może być użycie innej niższej wartości powiązanej, jeśli tablica ma być używana z innymi językami, takimi jak Visual Basic.

Górna granica zależy od liczby elementów i dolnej wartości powiązanej. Jeśli na przykład dolna granica wynosi 0, a liczba elementów to 10, górna granica zostanie automatycznie ustawiona na 9.

Zobacz też

Omówienie klasy