Método Page.DropContainer (Visio)

Crea un nuevo objeto Shape 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
Objeto a soltar Obligatorio [DESCONOCIDO] La forma de contenedor que se va a agregar a la página. Puede ser un objeto Master, MasterShortcut, Shape o IDataObject .
Formas de destino Obligatorio [DESCONOCIDO] 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 , utilice los métodos Documents.OpenEx y Application.GetBuiltInStencilFile y pasándole visBuiltInStencilContainers para abrir la galería de símbolos de contenedor integrada oculta. Después, use la propiedad Masters.ItemU para obtener el contenedor específico 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 del 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 utilizar el método DropContainer para agregar un contenedor desde la galería de símbolos de contenedor integrada oculta a la página activa para que contenga 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.

  • Last updated on