Método Page.DropIntoList (Visio)
Coloca el objeto especificado en la lista y posición indicadas. Devuelve la forma recién colocada.
Sintaxis
expresión. DropIntoList( _ObjectToDrop_ , _TargetList_ , _lPosition_ )
Expresión Expresión que devuelve un objeto Page .
Parameters
| Nombre | Obligatorio/opcional | Tipo de datos | Descripción |
|---|---|---|---|
| ObjectToDrop | Obligatorio | IUnknown | El origen de la forma que se va a colocar en la lista. Puede ser un objeto Master, Selection, Shape o IDataObject . Para obtener más información, vea los Comentarios. |
| TargetList | Obligatorio | Shape | Lista en la que se va a colocar ObjectToDrop. |
| lPosition | Necesario | Long | Posición en la lista basada en 1 en la que se va a agregar la forma. |
Valor devuelto
Shape
Comentarios
Si ObjectToDrop es un objeto Selection, la selección sólo puede contener una forma.
Si ObjectToDrop es un IDataObject, debe estar asociado con un objeto de Microsoft Visio local que pertenezca a la misma instancia que la página en que se ha colocado.
Visio devuelve un error De destino no válido si ObjectToDrop no coincide con los requisitos de categoría de la lista o del contenedor. Las formas se pueden asignar a categorías, y los contenedores pueden tener categorías requeridas y excluidas.
Las categorías son cadenas definidas por el usuario que se pueden usar para clasificar las formas y, de esa manera, restringir la pertenencia en un contenedor. Las categorías se pueden definir en la celda User.msvShapeCategories, en la ShapeSheet de una forma. Se pueden definir varias categorías para una forma, separándolas con punto y coma.
Si ObjectToDrop no es un objeto de Microsoft Visio, o si no contiene formas de nivel superior en la página, Microsoft Visio devuelve un error "Parámetro no válido".
Si la propiedad ContainerProperties.LockMembership de la lista es True, Visio devuelve un error Deshabilitado.
Ejemplo:
En el siguiente ejemplo de Visual Basic para Aplicaciones (VBA) se muestra cómo usar el método DropIntoList para agregar una nueva forma a una lista existente en la página activa, en la primera posición de la lista.
Application.ActivePage.DropIntoList vsoMaster, vsoListShape, 1
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.