Método Page.DropContainer (Visio)

Crea un nuevo objeto Shape de contenedor en la página, coloca el contenedor alrededor de las formas de destino especificadas y agrega las formas de destino al contenedor. Devuelve la forma de contenedor.

Sintaxis

expresión. DropContainer( _ObjectToDrop_ , _TargetShapes_ )

Expresión Variable que representa un objeto Page .

Parameters

Nombre	Obligatorio/opcional	Tipo de datos	Descripción
ObjectToDrop	Obligatorio	[UNKNOWN]	La forma de contenedor que se va a agregar a la página. Puede ser un objeto Master, MasterShortcut, Shape o IDataObject .
TargetShapes	Obligatorio	[UNKNOWN]	Las formas que el contenedor debe contener. Pueden ser un objeto Shape o Selection. Las formas o la selección ya deben estar en la página.

Valor devuelto

Shape

Comentarios

Para pasar un objeto Master para el parámetro ObjectToDrop , use el método Documents.OpenEx y el método Application.GetBuiltInStencilFile , pasandolo visBuiltInStencilContainers, para abrir la galería de símbolos de contenedor oculta y integrada. A continuación, use la propiedad Masters.ItemU para obtener el contenedor determinado que desea de la galería de símbolos.

Microsoft Visio debe proporcionar un IDataObject para pasar a ObjectToDrop, que debe pertenecer al mismo espacio de procesos que Visio.

Si ObjectToDrop no es un objeto de Visio o no es un contenedor, Visio devuelve un error "Parámetro no válido". Si el valor pasado es una forma que no coincide con el contexto del método, Visio devuelve un error "Origen no válido".

Si el parámetro TargetShapes es Nothing, Visio coloca la forma de contenedor en el centro de la página, sin ninguna forma de destino. Si las formas de destino especificadas no pertenecen al nivel superior de la página, Visio devuelve un error "Parámetro no válido".

El método DropContainer corresponde al comando Insertar contenedor de la interfaz de usuario de Visio. (En la ficha Insertar, haga clic en Contenedor).

Ejemplo:

En el siguiente ejemplo de Visual Basic para Aplicaciones (VBA) se muestra cómo usar el método DropContainer para agregar un contenedor desde la galería de símbolos de contenedor oculta y integrada a la página activa para contener la forma o formas seleccionadas. Antes de ejecutar esta macro, asegúrese de que hay una forma seleccionada (o una selección de formas) en la página activa.

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

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.