CComSafeArrayBound – třída

Tato třída je obálka pro STRUKTURU SAFEARRAYBOUND .

Syntaxe

class CComSafeArrayBound : public SAFEARRAYBOUND

Členové

Metody

Function	Popis
CCom Sejf ArrayBound	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 CCom Sejf Array. 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

CCom Sejf ArrayBound::CCom Sejf ArrayBound

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.

CCom Sejf ArrayBound::GetCount

Voláním této metody vrátíte počet prvků.

ULONG GetCount() const throw();

Vrácená 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 CCom Sejf Array::GetCount.

CCom Sejf ArrayBound::GetLowerBound

Voláním této metody vrátíte dolní mez.

LONG GetLowerBound() const throw();

Vrácená hodnota

Vrátí dolní mez objektu CComSafeArrayBound .

CCom Sejf ArrayBound::GetUpperBound

Voláním této metody vrátíte horní mez.

LONG GetUpperBound() const throw();

Vrácená 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.

CCom Sejf ArrayBound::operator =

Nastaví hodnotu CComSafeArrayBound na novou hodnotu.

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

Parametry

Vázán
Objekt CComSafeArrayBound .

UlCount
Počet prvků.

Vrácená 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í.

CCom Sejf ArrayBound::SetCount

Voláním této metody nastavíte počet prvků.

ULONG SetCount(ULONG ulCount) throw();

Parametry

UlCount
Počet prvků.

Vrácená hodnota

Vrátí počet prvků v objektu CComSafeArrayBound .

CCom Sejf ArrayBound::SetLowerBound

Voláním této metody nastavíte dolní mez.

LONG SetLowerBound(LONG lLowerBound) throw();

Parametry

lLowerBound
Dolní mez.

Vrácená 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.

Viz také

Přehled třídy