ContainerProperties.AddMember, méthode (Visio)
Ajoute une forme ou un ensemble de formes au conteneur.
Syntaxe
expression. AddMember (pObjectToAdd, addOptions)
Expression Variable qui représente un objet ContainerProperties .
Parameters
| Nom | Requis/Facultatif | Type de données | Description |
|---|---|---|---|
| pObjectToAdd | Requis | INCONNU | Forme ou formes à ajouter au conteneur. Peut être de type Shape ou Selection. |
| addOptions | Requis | VisMemberAddOptions | Détermine si le conteneur doit se développer pour contenir les formes ajoutées dans leur intégralité. Doit être l’une des constantes VisMemberAddOptions . |
Valeur renvoyée
Nothing
Remarques
La transmission de visMemberAddUseResizeSetting ou visMemberAddDoNotExpand pour addOptions peut créer une situation dans laquelle une forme est un membre de conteneur sans se trouver physiquement dans le conteneur. Si tel est le cas, la forme peut perdre son appartenance au conteneur lors de prochains déplacements ou redimensionnements du conteneur ou du membre.
Si le conteneur est une liste, AddMember ajoute l’objet spécifié au conteneur de liste, mais pas à la liste même. Autrement dit, la forme est contenue par la liste sans s’y trouver réellement. Cette situation est fréquente pour les formes se trouvant dans des conteneurs se trouvant eux-mêmes dans une liste.
Si la propriété ContainerProperties.LockMembership a la valeur True, Microsoft Visio renvoie une erreur Disabled.
Si le paramètre pObjectToAdd ne contient pas de formes de niveau supérieur sur la page, Visio renvoie une erreur Paramètre non valide.
Visio renvoie également une erreur Paramètres non valide si vous tentez d’utiliser la méthode AddMember pour ajouter la forme de conteneur même ou des sous-formes de conteneur au conteneur proprement dit.
Visio renvoie une erreur Target non valide si pObjectToAdd ne correspond pas aux exigences de catégorie de la liste ou du conteneur. Des catégories peuvent être attribuées aux formes, et les conteneurs peuvent contenir des catégories obligatoires et exclues.
Les catégories sont des chaînes définies par l’utilisateur que vous pouvez utiliser pour classer les formes, et par conséquent pour restreindre l’appartenance dans un conteneur. Vous pouvez définir des catégories dans la cellule User.msvShapeCategories de la feuille ShapeSheet pour une forme. Vous pouvez définir plusieurs catégories pour une forme en les séparant avec des points-virgules.
Exemple
L’exemple Visual Basic pour Applications (VBA) suivant montre comment utiliser la méthode AddMember pour ajouter un nouveau membre (vsoShape) à un conteneur existant (vsoContainerShape) sur une page. Le code suppose que vsoShape chevauche déjà vsoContainerShape.
vsoContainerShape.ContainerProperties.AddMember vsoShape, visMemberAddExpandContainer
Assistance et commentaires
Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.