CComSafeArrayBound – třída
Tato třída je obálka pro STRUKTURU SAFEARRAYBOUND .
Syntaxe
class CComSafeArrayBound : public SAFEARRAYBOUND
Členové
Metody
| Function | Popis |
|---|---|
| CComSafeArrayBound | Konstruktor |
| GetCount | Voláním této metody vrátíte počet prvků. |
| GetLowerBound | Voláním této metody vrátíte dolní mez. |
| GetUpperBound | Voláním této metody vrátíte horní mez. |
| SetCount | Voláním této metody nastavíte počet prvků. |
| SetLowerBound | Voláním této metody nastavíte dolní mez. |
Operátory
| Operátor | Popis |
|---|---|
| operator = | Nastaví hodnotu CComSafeArrayBound na novou hodnotu. |
Poznámky
Tato třída je obálka pro SAFEARRAYBOUND strukturu používanou CComSafeArray. Poskytuje metody pro dotazování a nastavení horní a dolní hranice jedné dimenze CComSafeArray objektu a počtu prvků, které obsahuje. Multidimenzionální CComSafeArray objekt používá pole CComSafeArrayBound objektů, jeden pro každou dimenzi. Proto při použití metod, jako je GetCount, mějte na paměti, že tato metoda nevrátí celkový počet prvků v multidimenzionálním poli.
Hlavička: atlsafe.h
Požadavky
Hlavička: atlsafe.h
CComSafeArrayBound::CComSafeArrayBound
Konstruktor
CComSafeArrayBound(ULONG ulCount = 0, LONG lLowerBound = 0) throw();
Parametry
UlCount
Počet prvků v poli.
lLowerBound
Dolní mez, ze které je matice číslona.
Poznámky
Pokud má být pole přístupné z programu C++, doporučuje se definovat dolní mez jako 0. Pokud se má pole použít s jinými jazyky, jako je Visual Basic, může být vhodnější použít jinou dolní mez hodnotu.
CComSafeArrayBound::GetCount
Voláním této metody vrátíte počet prvků.
ULONG GetCount() const throw();
Návratová hodnota
Vrátí počet prvků.
Poznámky
Pokud přidružený CComSafeArray objekt představuje multidimenzionální pole, tato metoda vrátí pouze celkový počet prvků v pravé části dimenze. K získání celkového počtu prvků použijte CComSafeArray::GetCount .
CComSafeArrayBound::GetLowerBound
Voláním této metody vrátíte dolní mez.
LONG GetLowerBound() const throw();
Návratová hodnota
Vrátí dolní mez objektu CComSafeArrayBound .
CComSafeArrayBound::GetUpperBound
Voláním této metody vrátíte horní mez.
LONG GetUpperBound() const throw();
Návratová hodnota
Vrátí horní mez objektu CComSafeArrayBound .
Poznámky
Horní mez závisí na počtu prvků a dolní vázané hodnotě. Pokud je například dolní mez 0 a počet prvků je 10, horní mez se automaticky nastaví na hodnotu 9.
CComSafeArrayBound::operator =
Nastaví hodnotu CComSafeArrayBound na novou hodnotu.
CComSafeArrayBound& operator= (const CComSafeArrayBound& bound) throw();
CComSafeArrayBound& operator= (ULONG ulCount) throw();
Parametry
vázaný
Objekt CComSafeArrayBound .
UlCount
Počet prvků.
Návratová hodnota
Vrátí ukazatel na CComSafeArrayBound objekt.
Poznámky
Objekt CComSafeArrayBound lze přiřadit pomocí existujícího CComSafeArrayBoundobjektu nebo zadáním počtu prvků, v takovém případě je dolní mez nastavena na hodnotu 0 ve výchozím nastavení.
CComSafeArrayBound::SetCount
Voláním této metody nastavíte počet prvků.
ULONG SetCount(ULONG ulCount) throw();
Parametry
UlCount
Počet prvků.
Návratová hodnota
Vrátí počet prvků v objektu CComSafeArrayBound .
CComSafeArrayBound::SetLowerBound
Voláním této metody nastavíte dolní mez.
LONG SetLowerBound(LONG lLowerBound) throw();
Parametry
lLowerBound
Dolní mez.
Návratová hodnota
Vrátí novou dolní mez objektu CComSafeArrayBound .
Poznámky
Pokud má být pole přístupné z programu Visual C++, doporučuje se definovat dolní mez jako 0. Pokud se má pole použít s jinými jazyky, jako je Visual Basic, může být vhodnější použít jinou dolní mez hodnotu.
Horní mez závisí na počtu prvků a dolní vázané hodnotě. Pokud je například dolní mez 0 a počet prvků je 10, horní mez se automaticky nastaví na hodnotu 9.