Classe CComSafeArrayBound
Questa classe è un wrapper per una struttura SAFEARRAYBOUND .
Sintassi
class CComSafeArrayBound : public SAFEARRAYBOUND
Membri
Metodi
| Funzione | Descrizione |
|---|---|
| CComSafeArrayBound | 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 usata da CComSafeArray. 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
CComSafeArrayBound::CComSafeArrayBound
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.
CComSafeArrayBound::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 CComSafeArray::GetCount per ottenere il numero totale di elementi.
CComSafeArrayBound::GetLowerBound
Chiamare questo metodo per restituire il limite inferiore.
LONG GetLowerBound() const throw();
Valore restituito
Restituisce il limite inferiore dell'oggetto CComSafeArrayBound .
CComSafeArrayBound::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.
CComSafeArrayBound::operator =
Imposta su CComSafeArrayBound un nuovo valore.
CComSafeArrayBound& operator= (const CComSafeArrayBound& bound) throw();
CComSafeArrayBound& operator= (ULONG ulCount) throw();
Parametri
limite
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.
CComSafeArrayBound::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 .
CComSafeArrayBound::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.