CComSafeArrayBound-Klasse

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

Syntax

class CComSafeArrayBound : public SAFEARRAYBOUND

Member

Methoden

Funktion Beschreibung
CComSafeArrayBound 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 struktur, die SAFEARRAYBOUND von CComSafeArray verwendet wird. 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

CComSafeArrayBound::CComSafeArrayBound

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.

CComSafeArrayBound::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 CComSafeArray::GetCount , um die Gesamtanzahl der Elemente abzurufen.

CComSafeArrayBound::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.

CComSafeArrayBound::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.

CComSafeArrayBound::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.

CComSafeArrayBound::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.

CComSafeArrayBound::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