Classe CComSafeArrayBound

Questa classe è un wrapper per una struttura SAFEARRAYBOUND .

Sintassi

class CComSafeArrayBound : public SAFEARRAYBOUND

Membri

Metodi

Funzione	Descrizione
CCom Cassaforte ArrayBound	Costruttore.
GetCount	Chiamare questo metodo per restituire il numero di elementi.
GetLowerBound	Chiamare questo metodo per restituire il limite inferiore.
Getupperbound	Chiamare questo metodo per restituire il limite superiore.
SetCount	Chiamare questo metodo per impostare il numero di elementi.
SetLowerBound	Chiamare questo metodo per impostare il limite inferiore.

Operatori

Operatore	Descrizione
operator =	Imposta su CComSafeArrayBound un nuovo valore.

Osservazioni:

Questa classe è un wrapper per la SAFEARRAYBOUND struttura utilizzata da CCom Cassaforte Array. Fornisce metodi per l'esecuzione di query e l'impostazione dei limiti superiori e inferiori di una singola dimensione di un CComSafeArray oggetto e il numero di elementi contenuti. Un oggetto multidimensionale CComSafeArray usa una matrice di CComSafeArrayBound oggetti, una per ogni dimensione. Pertanto, quando si usano metodi come GetCount, tenere presente che questo metodo non restituirà il numero totale di elementi in una matrice multidimensionale.

Intestazione: atlsafe.h

Requisiti

Intestazione: atlsafe.h

CCom Cassaforte ArrayBound::CCom Cassaforte ArrayBound

Costruttore.

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

Parametri

ulCount
Numero di elementi nella matrice.

lLowerBound
Limite inferiore da cui viene numerata la matrice.

Osservazioni:

Se è necessario accedere alla matrice da un programma C++, è consigliabile definire il limite inferiore come 0. Può essere preferibile usare un valore di limite inferiore diverso se la matrice deve essere usata con altri linguaggi, ad esempio Visual Basic.

CCom Cassaforte ArrayBound::GetCount

Chiamare questo metodo per restituire il numero di elementi.

ULONG GetCount() const throw();

Valore restituito

Restituisce il numero di elementi.

Osservazioni:

Se l'oggetto associato CComSafeArray rappresenta una matrice multidimensionale, questo metodo restituirà solo il numero totale di elementi nella dimensione più a destra. Usare CCom Cassaforte Array::GetCount per ottenere il numero totale di elementi.

CCom Cassaforte ArrayBound::GetLowerBound

Chiamare questo metodo per restituire il limite inferiore.

LONG GetLowerBound() const throw();

Valore restituito

Restituisce il limite inferiore dell'oggetto CComSafeArrayBound .

CCom Cassaforte ArrayBound::GetUpperBound

Chiamare questo metodo per restituire il limite superiore.

LONG GetUpperBound() const throw();

Valore restituito

Restituisce il limite superiore dell'oggetto CComSafeArrayBound .

Osservazioni:

Il limite superiore dipende dal numero di elementi e dal valore di limite inferiore. Ad esempio, se il limite inferiore è 0 e il numero di elementi è 10, il limite superiore verrà impostato automaticamente su 9.

CCom Cassaforte ArrayBound::operator =

Imposta su CComSafeArrayBound un nuovo valore.

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

Parametri

Associato
Oggetto CComSafeArrayBound.

ulCount
Numero di elementi.

Valore restituito

Restituisce un puntatore all'oggetto CComSafeArrayBound .

Osservazioni:

L'oggetto CComSafeArrayBound può essere assegnato usando un oggetto esistente CComSafeArrayBoundo specificando il numero di elementi, nel qual caso il limite inferiore è impostato su 0 per impostazione predefinita.

CCom Cassaforte ArrayBound::SetCount

Chiamare questo metodo per impostare il numero di elementi.

ULONG SetCount(ULONG ulCount) throw();

Parametri

ulCount
Numero di elementi.

Valore restituito

Restituisce il numero di elementi nell'oggetto CComSafeArrayBound .

CCom Cassaforte ArrayBound::SetLowerBound

Chiamare questo metodo per impostare il limite inferiore.

LONG SetLowerBound(LONG lLowerBound) throw();

Parametri

lLowerBound
Limite inferiore.

Valore restituito

Restituisce il nuovo limite inferiore dell'oggetto CComSafeArrayBound .

Osservazioni:

Se è necessario accedere alla matrice da un programma Visual C++, è consigliabile definire il limite inferiore come 0. Può essere preferibile usare un valore di limite inferiore diverso se la matrice deve essere usata con altri linguaggi, ad esempio Visual Basic.

Il limite superiore dipende dal numero di elementi e dal valore di limite inferiore. Ad esempio, se il limite inferiore è 0 e il numero di elementi è 10, il limite superiore verrà impostato automaticamente su 9.

Vedi anche

Cenni preliminari sulla classe