Método Shape.LinkToData (Visio)

Vincula una forma a una fila de datos de un conjunto de registros de datos.

Nota:

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

Sintaxis

expresión. LinkToData( _DataRecordsetID_ , _RowID_ , _AutoApplyDataGraphics_ )

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

Parameters

Nombre Obligatorio/opcional Tipo de datos Descripción
DataRecordsetID Necesario Long Identificador del conjunto de registros de datos que contiene los datos a los que se va a vincular.
Identificador Necesario Long Identificador de la fila del conjunto de registros de datos que contiene el registro de datos concreto que se vinculará.
AutoApplyDataGraphics Opcional Boolean Si se aplicará automáticamente un gráfico de datos a las formas vinculadas. Vea Comentarios para obtener más información.

Valor devuelto

Nothing

Comentarios

El método Shape.LinkToData funciona de manera muy parecida al mismo método del objeto Selection, Selection.LinkToData, con la excepción de que vincula una sola forma, en lugar de una selección de formas, a una misma fila de datos.

Si se pasa True para el parámetro AutoApplyDataGraphics, Microsoft Visio vuelve a aplicar el gráfico de datos existente a una forma a la que ya se había aplicado un gráfico de datos antes de llamar al método. Para una forma que no tenía ningún gráfico de datos previamente, Visio aplicará el último gráfico de datos que se haya aplicado a cualquier otra forma del documento activo.

Ejemplo:

La siguiente macro de Microsoft Visual Basic para Aplicaciones (VBA) muestra cómo utilizar el método LinkToData para vincular una forma a una fila de datos.

Antes de ejecutar esta macro, agregue al menos un conjunto de registros de datos a la colección DataRecordsets del documento. En la macro se usa el identificador del último conjunto de registros de datos que se ha agregado a la colección. Dibuja una forma de rectángulo en la página y la vincula a los datos de la primera fila del conjunto de registros de datos, al tiempo que aplica el gráfico de datos predeterminado a la forma.

Public Sub LinkToData_Example() 
 
    Dim vsoDataRecordset As Visio.DataRecordset 
    Dim vsoShape As Visio.Shape 
    Dim intCount As Integer 
     
    intCount = Visio.ActiveDocument.DataRecordsets.Count 
    Set vsoDataRecordset = Visio.ActiveDocument.DataRecordsets(intCount) 
     
    Set vsoShape = ActivePage.DrawRectangle(2, 2, 5, 5) 
     
    vsoShape.LinkToData vsoDataRecordset.ID, 1, True 
 
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.