Klasa CComSafeArrayBound

Ta klasa jest otoką struktury SAFEARRAYBOUND .

Składnia

class CComSafeArrayBound : public SAFEARRAYBOUND

Członkowie

Metody

Function	opis
CCom Sejf ArrayBound	Konstruktor.
GetCount	Wywołaj tę metodę, aby zwrócić liczbę elementów.
GetLowerBound	Wywołaj tę metodę, aby zwrócić dolną granicę.
Getupperbound	Wywołaj tę metodę, aby zwrócić górną granicę.
SetCount	Wywołaj tę metodę, aby ustawić liczbę elementów.
SetLowerBound	Wywołaj tę metodę, aby ustawić dolną granicę.

Operatory

Operator	opis
operator =	CComSafeArrayBound Ustawia wartość na nową.

Uwagi

Ta klasa jest otoką struktury używanej SAFEARRAYBOUND przez CCom Sejf Array. 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

CCom Sejf ArrayBound::CCom Sejf ArrayBound

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.

CCom Sejf ArrayBound::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 CCom Sejf Array::GetCount, aby uzyskać całkowitą liczbę elementów.

CCom Sejf ArrayBound::GetLowerBound

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

LONG GetLowerBound() const throw();

Wartość zwracana

Zwraca dolną granicę CComSafeArrayBound obiektu.

CCom Sejf ArrayBound::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.

CCom Sejf ArrayBound::operator =

CComSafeArrayBound Ustawia wartość na nową.

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

Parametry

Powiązane
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.

CCom Sejf ArrayBound::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.

CCom Sejf ArrayBound::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