CComSafeArrayBound, classe
Cette classe est un wrapper pour une structure SAFEARRAYBOUND .
Syntaxe
class CComSafeArrayBound : public SAFEARRAYBOUND
Membres
Méthodes
| Fonction | Description |
|---|---|
| CComSafeArrayBound | 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 CComSafeArray. 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
CComSafeArrayBound ::CComSafeArrayBound
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.
CComSafeArrayBound ::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 CComSafeArray ::GetCount pour obtenir le nombre total d’éléments.
CComSafeArrayBound ::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 .
CComSafeArrayBound ::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.
CComSafeArrayBound ::operator =
Définit la CComSafeArrayBound valeur sur une nouvelle valeur.
CComSafeArrayBound& operator= (const CComSafeArrayBound& bound) throw();
CComSafeArrayBound& operator= (ULONG ulCount) throw();
Paramètres
limite
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.
CComSafeArrayBound ::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 .
CComSafeArrayBound ::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.