Klasa CComSafeArrayBound
Ta klasa jest otoką struktury SAFEARRAYBOUND .
Składnia
class CComSafeArrayBound : public SAFEARRAYBOUND
Elementy członkowskie
Metody
| Function | opis |
|---|---|
| CComSafeArrayBound | 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 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.