Partager via


Méthode Page.DropContainer (Visio)

Crée un objet Shape de conteneur sur la page, place le conteneur autour des formes cibles spécifiées et ajoute les formes cibles au conteneur. Renvoie la forme du conteneur.

Syntaxe

expression. DropContainer( _ObjectToDrop_ , _TargetShapes_ )

Expression Variable qui représente un objet Page .

Parameters

Nom Requis/Facultatif Type de données Description
ObjectToDrop Requis [UNKNOWN] Forme de conteneur à ajouter à la page. Il peut s’agir d’un objet Master, MasterShortcut, Shape ou IDataObject .
TargetShapes Requis [UNKNOWN] Formes que le conteneur doit contenir. Il peut s’agir d’un objet Shape ou Selection. Les formes ou la sélection doivent déjà se trouver sur la page.

Valeur renvoyée

Forme

Remarques

Pour passer un objet Master pour le paramètre ObjectToDrop , utilisez la méthode Documents.OpenEx et la méthode Application.GetBuiltInStencilFile , en lui transmettant visBuiltInStencilContainers, pour ouvrir le gabarit de conteneur intégré masqué. Utilisez ensuite la propriété Masters.ItemU pour obtenir le conteneur particulier que vous souhaitez à partir du gabarit.

L’objet IDataObject que vous passez au paramètre ObjectToDrop doit être fourni par Microsoft Visio et se trouver dans le même espace de processus que Visio.

Si le paramètre ObjectToDrop n’est pas un objet Visio, ni un conteneur, Visio renvoie une erreur Paramètre non valide. Si la valeur passée est une forme qui ne correspond pas au contexte de la méthode, Visio renvoie une erreur Source non valide.

Si le paramètre TargetShapes a la valeur Nothing, Visio place la forme de conteneur au centre de la page, sans aucune forme cible. Si les formes cibles spécifiées ne sont pas des membres de niveau supérieur de la page, Visio renvoie une erreur Paramètre non valide.

La méthode DropContainer correspond à la commande Insérer un conteneur dans l’interface utilisateur de Visio. (Sous l’onglet Insertion , cliquez sur Conteneur.)

Exemple

L’exemple Visual Basic pour Applications (VBA) suivant montre comment utiliser la méthode DropContainer pour ajouter un conteneur à partir du gabarit de conteneur intégré masqué à la page active pour contenir la ou les formes sélectionnées. Avant d’exécuter cette macro, assurez-vous qu’il existe une forme sélectionnée (ou une sélection de formes) sur la page active.

Public Sub DropContainer_Example()

    Dim vsoDocument As Visio.Document
    Set vsoDocument = Application.Documents.OpenEx(Application.GetBuiltInStencilFile(visBuiltInStencilContainers, visMSUS), visOpenHidden)
    Application.ActivePage.DropContainer vsoDocument.Masters.ItemU("Container 1"), Application.ActiveWindow.Selection
    vsoDocument.Close
    
End Sub

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.