Método Selection.LinkToData (Visio)

Vincula una selección de formas a una sola 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_ , _DataRowID_ , _AutoApplyDataGraphics_ )

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

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.
DataRowID	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 Selection.LinkToData funciona de manera parecida al mismo método del objeto Shape, Shape.LinkToData, con la excepción de que vincula una selección de formas, en lugar de una sola, a una misma fila de datos.

Si Visio no puede establecer un vínculo entre una forma y la fila de datos, omite esa forma y va directamente a la siguiente que figura en la selección. Después de ejecutar el método , para determinar si todas las formas de la selección están realmente vinculadas a la fila de datos, llame al método Shape.GetLinkedDataRow en cada forma de la selección. Si el método devuelve un error para cualquier forma, indica que ésta no está vinculada a la fila de datos. Visio normalmente vinculará correctamente una fila a una forma a menos que la forma ya esté vinculada a datos y la configuración de comportamiento de reemplazo de vínculos para el conjunto de registros de datos especifica que no se debe reemplazar el vínculo.

Si se pasa True para el parámetro AutoApplyDataGraphics, Visio vuelve a aplicar el gráfico de datos existente a aquellas formas a las que ya se había aplicado un gráfico de datos antes de llamar al método. Para las formas que no tenían 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 las formas de una selección a una fila de datos.

Antes de ejecutar esta macro, coloque varias formas en la página y 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. Se vinculan las formas seleccionadas a los datos de la primera fila del conjunto de registros de datos.

Public Sub LinkToData_Example() 
 
    Dim vsoDataRecordset As Visio.DataRecordset 
    Dim vsoSelection As Visio.Selection 
    Dim intCount As Integer 
     
    intCount = Visio.ActiveDocument.DataRecordsets.Count 
    Set vsoDataRecordset = Visio.ActiveDocument.DataRecordsets(intCount) 
     
    ActiveWindow.DeselectAll 
    ActiveWindow.SelectAll 
     
    Set vsoSelection = ActiveWindow.Selection 
    vsoSelection.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.