CComSafeArrayBound, classe

Cette classe est un wrapper pour une structure SAFEARRAYBOUND .

Syntaxe

class CComSafeArrayBound : public SAFEARRAYBOUND

Membres

Méthodes

Fonction	Description
CCom Coffre ArrayBound	Constructeur .
GetCount	Appelez cette méthode pour retourner le nombre d’éléments.
GetLowerBound	Appelez cette méthode pour retourner la limite inférieure.
GetUpperBound	Appelez cette méthode pour retourner la limite supérieure.
SetCount	Appelez cette méthode pour définir le nombre d’éléments.
SetLowerBound	Appelez cette méthode pour définir la limite inférieure.

Opérateurs

Opérateur	Description
operator =	Définit la CComSafeArrayBound valeur sur une nouvelle valeur.

Notes

Cette classe est un wrapper pour la SAFEARRAYBOUND structure utilisée par CCom Coffre Array. Il fournit des méthodes pour interroger et définir les limites supérieures et inférieures d’une dimension unique d’un CComSafeArray objet et le nombre d’éléments qu’il contient. Un objet multidimensionnel CComSafeArray utilise un tableau d’objets CComSafeArrayBound , un pour chaque dimension. Par conséquent, lorsque vous utilisez des méthodes telles que GetCount, sachez que cette méthode ne retourne pas le nombre total d’éléments dans un tableau multidimensionnel.

En-tête : atlsafe.h

Spécifications

En-tête : atlsafe.h

CCom Coffre ArrayBound ::CCom Coffre ArrayBound

Constructeur .

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

Paramètres

ulCount
Nombre d’éléments dans le tableau.

lLowerBound
Limite inférieure à partir de laquelle le tableau est numéroté.

Notes

Si le tableau est accessible à partir d’un programme C++, il est recommandé que la limite inférieure soit définie comme 0. Il peut être préférable d’utiliser une autre valeur de limite inférieure si le tableau doit être utilisé avec d’autres langages, tels que Visual Basic.

CCom Coffre ArrayBound ::GetCount

Appelez cette méthode pour retourner le nombre d’éléments.

ULONG GetCount() const throw();

Valeur de retour

Retourne le nombre d’éléments.

Notes

Si l’objet associé CComSafeArray représente un tableau multidimensionnel, cette méthode retourne uniquement le nombre total d’éléments dans la dimension la plus à droite. Utilisez CCom Coffre Array ::GetCount pour obtenir le nombre total d’éléments.

CCom Coffre ArrayBound ::GetLowerBound

Appelez cette méthode pour retourner la limite inférieure.

LONG GetLowerBound() const throw();

Valeur de retour

Retourne la limite inférieure de l’objet CComSafeArrayBound .

CCom Coffre ArrayBound ::GetUpperBound

Appelez cette méthode pour retourner la limite supérieure.

LONG GetUpperBound() const throw();

Valeur de retour

Retourne la limite supérieure de l’objet CComSafeArrayBound .

Notes

La limite supérieure dépend du nombre d’éléments et de la valeur de limite inférieure. Par exemple, si la limite inférieure est 0 et que le nombre d’éléments est 10, la limite supérieure est automatiquement définie sur 9.

CCom Coffre ArrayBound ::operator =

Définit la CComSafeArrayBound valeur sur une nouvelle valeur.

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

Paramètres

Lié
Objet CComSafeArrayBound.

ulCount
Nombre d'éléments.

Valeur de retour

Retourne un pointeur vers l’objet CComSafeArrayBound .

Notes

L’objet CComSafeArrayBound peut être affecté à l’aide d’un élément existant CComSafeArrayBoundou en fournissant le nombre d’éléments, auquel cas la limite inférieure est définie sur 0 par défaut.

CCom Coffre ArrayBound ::SetCount

Appelez cette méthode pour définir le nombre d’éléments.

ULONG SetCount(ULONG ulCount) throw();

Paramètres

ulCount
Nombre d'éléments.

Valeur de retour

Retourne le nombre d’éléments dans l’objet CComSafeArrayBound .

CCom Coffre ArrayBound ::SetLowerBound

Appelez cette méthode pour définir la limite inférieure.

LONG SetLowerBound(LONG lLowerBound) throw();

Paramètres

lLowerBound
Limite inférieure.

Valeur de retour

Retourne la nouvelle limite inférieure de l’objet CComSafeArrayBound .

Notes

Si le tableau est accessible à partir d’un programme Visual C++, il est recommandé que la limite inférieure soit définie comme 0. Il peut être préférable d’utiliser une autre valeur de limite inférieure si le tableau doit être utilisé avec d’autres langages, tels que Visual Basic.

La limite supérieure dépend du nombre d’éléments et de la valeur de limite inférieure. Par exemple, si la limite inférieure est 0 et que le nombre d’éléments est 10, la limite supérieure est automatiquement définie sur 9.

Voir aussi

Vue d’ensemble de la classe