Compartir a través de

Método GraphicItems.AddCopy (Visio)

  • Artículo

Agrega una copia de un objeto GraphicItem a la colección GraphicItems de un Master de tipo visTypeDataGraphic.

Nota:

Este objeto o miembro Visio solo se encuentra disponible para los usuarios con licencia de Visio Professional 2013.

Sintaxis

expresión. AddCopy( _GraphicItem_ )

Expresión Expresión que devuelve un objeto GraphicItems .

Parameters

Nombre Obligatorio/opcional Tipo de datos Descripción
Graphicitem Obligatorio [IVGRAPHICITEM] El objeto GraphicItem que se va a copiar.

Valor devuelto

Graphicitem

Comentarios

El objeto GraphicItem que se va a agregar debe existir ya en la colección GraphicItems de otro objeto Master de tipo visTypeDataGraphic.

Después de usar Master.Open para abrir una copia de un objeto Master de tipo visTypeDataGraphic para modificarla, debe usar el método Master.Close para confirmar los cambios realizados en el patrón mientras estaba abierto. Al cerrar una copia de un patrón de gráfico de datos también se vuelve a aplicar el gráfico de datos a todas las formas a las que se había aplicado previamente.

Nota:

Para obtener más información sobre por qué es necesario editar una copia de un patrón en lugar de la propia maestra, vea Master.Open.

Ejemplo:

La siguiente macro de Microsoft Visual Basic para Aplicaciones (VBA) muestra cómo utilizar el método AddCopy para agregar una copia de un elemento de gráfico de datos existente a la colección GraphicItems de un objeto Master.

En la macro se utiliza el método Masters.AddEx para agregar un nuevo objeto Master de tipo visTypeDataGraphic a la colección Masters del documento activo. A continuación, usa el método Master.Open para obtener una copia del nuevo patrón de gráficos de datos que se va a editar.

A continuación, el método obtiene una copia de un elemento gráfico de datos existente que es el primer elemento de la colección GraphicItems de un patrón existente. Por último, se utiliza el método AddCopy para agregar la copia del elemento de gráfico de datos existente a la colección GraphicItems de la copia del nuevo patrón, y se cierra la copia del patrón.

La macro supone que conoce el nombre del patrón de gráficos de datos existente (" old_master_name ") que contiene uno o varios elementos gráficos que desea agregar al nuevo patrón. Para determinar el nombre de un patrón de gráficos de datos existente, mueva el mouse sobre el patrón en el panel de tareas Gráficos de datos de la interfaz de usuario de Visio.

Public Sub AddCopy_Example() 
 
    Dim vsoMaster As Visio.Master 
    Dim vsoMasterCopy As Visio.Master 
    Dim vsoMaster_Old As Visio.Master 
    Dim vsoGraphicItem As GraphicItem 
    Dim vsoGraphicItem_Old As Visio.GraphicItem 
 
    Set vsoMaster = Visio.ActiveDocument.Masters.AddEx(visTypeDataGraphic) 
    Set vsoMasterCopy = vsoMaster.Open 
    Set vsoMaster_Old = ActiveDocument.Masters("old_master_name ") 
    Set vsoGraphicItem_Old = vsoMaster_Old.GraphicItems(1) 
    Set vsoGraphicItem = vsoMasterCopy.GraphicItems.AddCopy(vsoGraphicItem_Old) 
    vsoMasterCopy.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.