Méthode Page.DropIntoList (Visio)

Dépose l’objet spécifié dans la liste spécifiée à la position spécifiée. Renvoie la forme nouvellement déposée.

Syntaxe

expression. DropIntoList( _ObjectToDrop_ , _TargetList_ , _lPosition_ )

Expression Expression qui renvoie un objet Page .

Parameters

Nom	Requis/Facultatif	Type de données	Description
ObjectToDrop	Requis	Iunknown	Source de la forme à déposer dans la liste. Il peut s’agir d’un objet Master, Selection, Shape ou IDataObject . Voir la section Remarques pour plus d'informations.
TargetList	Requis	Forme	Liste dans laquelle déposer ObjectToDrop.
lPosition	Obligatoire	Long	Position dans la liste en base un sur laquelle ajouter la forme.

Valeur renvoyée

Forme

Remarques

Si ObjectToDrop est un objet Selection, la sélection peut ne peut contenir qu’une seule forme.

Si ObjectToDrop est un objet IDataObject, il doit être associé à un objet Microsoft Visio local se trouvant dans la même instance que la page sur laquelle il est déposé.

Visio renvoie une erreur Cible non valide si ObjectToDrop 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.

Si ObjectToDrop n’est pas un objet Microsoft Visio, ou s’il ne contient pas de formes de niveau supérieur sur la page, Microsoft Visio renvoie une erreur Paramètre non valide.

Si la propriété ContainerProperties.LockMembership de la liste a la valeur True, Visio renvoie une erreur Disabled.

Exemple

L’exemple Visual Basic pour Applications (VBA) suivant montre comment utiliser la méthode DropIntoList pour ajouter une nouvelle forme à une liste existante sur la page active, en première position de la liste.

Application.ActivePage.DropIntoList vsoMaster, vsoListShape, 1

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.