CComSafeArrayBound-Klasse

Diese Klasse ist ein Wrapper für eine SAFEARRAYBOUND-Struktur .

Syntax

class CComSafeArrayBound : public SAFEARRAYBOUND

Mitglieder

Methoden

Function	Beschreibung
CCom Tresor ArrayBound	Der Konstruktor.
GetCount	Rufen Sie diese Methode auf, um die Anzahl der Elemente zurückzugeben.
Getlowerbound	Rufen Sie diese Methode auf, um die untere Grenze zurückzugeben.
Getupperbound	Rufen Sie diese Methode auf, um die obere Grenze zurückzugeben.
SetCount	Rufen Sie diese Methode auf, um die Anzahl der Elemente festzulegen.
SetLowerBound	Rufen Sie diese Methode auf, um die untere Grenze festzulegen.

Operatoren

Operator	Beschreibung
operator =	Legt den CComSafeArrayBound Wert auf einen neuen Wert fest.

Hinweise

Diese Klasse ist ein Wrapper für die SAFEARRAYBOUND von CCom Tresor Array verwendete Struktur. Es stellt Methoden zum Abfragen und Festlegen der oberen und unteren Grenzen einer einzelnen Dimension eines CComSafeArray Objekts und der Anzahl der darin enthaltenen Elemente bereit. Ein multidimensionales CComSafeArray Objekt verwendet ein Array von CComSafeArrayBound Objekten, eines für jede Dimension. Beachten Sie daher bei Verwendung von Methoden wie GetCount, dass diese Methode nicht die Gesamtanzahl der Elemente in einem mehrdimensionalen Array zurückgibt.

Header: atlsafe.h

Anforderungen

Header: atlsafe.h

CCom Tresor ArrayBound::CCom Tresor ArrayBound

Der Konstruktor.

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

Parameter

ulCount
Die Anzahl der Elemente im Array.

lLowerBound
Die untere Grenze, aus der das Array nummeriert ist.

Hinweise

Wenn auf das Array über ein C++-Programm zugegriffen werden soll, empfiehlt es sich, die untere Grenze als 0 zu definieren. Möglicherweise empfiehlt es sich, einen anderen untergrenzenden Wert zu verwenden, wenn das Array mit anderen Sprachen verwendet werden soll, z. B. Visual Basic.

CCom Tresor ArrayBound::GetCount

Rufen Sie diese Methode auf, um die Anzahl der Elemente zurückzugeben.

ULONG GetCount() const throw();

Rückgabewert

Gibt die Anzahl der Elemente zurück.

Hinweise

Wenn das zugeordnete CComSafeArray Objekt ein mehrdimensionales Array darstellt, gibt diese Methode nur die Gesamtanzahl der Elemente in der äußerst rechten Dimension zurück. Verwenden Sie CCom Tresor Array::GetCount, um die Gesamtanzahl der Elemente abzurufen.

CCom Tresor ArrayBound::GetLowerBound

Rufen Sie diese Methode auf, um die untere Grenze zurückzugeben.

LONG GetLowerBound() const throw();

Rückgabewert

Gibt die untere Grenze des CComSafeArrayBound Objekts zurück.

CCom Tresor ArrayBound::GetUpperBound

Rufen Sie diese Methode auf, um die obere Grenze zurückzugeben.

LONG GetUpperBound() const throw();

Rückgabewert

Gibt die obere Grenze des CComSafeArrayBound Objekts zurück.

Hinweise

Die obere Grenze hängt von der Anzahl der Elemente und dem wert der unteren Grenze ab. Wenn die untere Grenze beispielsweise 0 ist und die Anzahl der Elemente 10 ist, wird die obere Grenze automatisch auf 9 festgelegt.

CCom Tresor ArrayBound::operator =

Legt den CComSafeArrayBound Wert auf einen neuen Wert fest.

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

Parameter

Gebunden
Ein CComSafeArrayBound-Objekt.

ulCount
Die Anzahl der Elemente.

Rückgabewert

Gibt einen Zeiger auf das CComSafeArrayBound Objekt zurück.

Hinweise

Das CComSafeArrayBound Objekt kann mithilfe eines vorhandenen CComSafeArrayBoundObjekts oder durch Angeben der Anzahl der Elemente zugewiesen werden, in diesem Fall wird die Untergrenze standardmäßig auf 0 festgelegt.

CCom Tresor ArrayBound::SetCount

Rufen Sie diese Methode auf, um die Anzahl der Elemente festzulegen.

ULONG SetCount(ULONG ulCount) throw();

Parameter

ulCount
Die Anzahl der Elemente.

Rückgabewert

Gibt die Anzahl der Elemente im CComSafeArrayBound Objekt zurück.

CCom Tresor ArrayBound::SetLowerBound

Rufen Sie diese Methode auf, um die untere Grenze festzulegen.

LONG SetLowerBound(LONG lLowerBound) throw();

Parameter

lLowerBound
Die untere Grenze.

Rückgabewert

Gibt die neue untere Grenze des CComSafeArrayBound Objekts zurück.

Hinweise

Wenn auf das Array über ein Visual C++-Programm zugegriffen werden soll, empfiehlt es sich, die untere Grenze als 0 zu definieren. Möglicherweise empfiehlt es sich, einen anderen untergrenzenden Wert zu verwenden, wenn das Array mit anderen Sprachen verwendet werden soll, z. B. Visual Basic.

Die obere Grenze hängt von der Anzahl der Elemente und dem wert der unteren Grenze ab. Wenn die untere Grenze beispielsweise 0 ist und die Anzahl der Elemente 10 ist, wird die obere Grenze automatisch auf 9 festgelegt.

Siehe auch

Klassenübersicht