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.