Compartilhar via

Shape.LinkToData method (Visio) (Método Shape.LinkToData [Visio])

Vincula uma forma a uma linha de dados de um conjunto de registros de dados.

Observação

This Visio object or member is available only to licensed users of Visio Professional 2013.

Sintaxe

expression. LinkToData( _DataRecordsetID_ , _RowID_ , _AutoApplyDataGraphics_ )

expressão Uma expressão que devolve um objeto Forma .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
DataRecordsetID Obrigatório Long O ID do conjunto de registos de dados que contém os dados a ligar.
RowID Obrigatório Long A identificação da linha no conjunto de registros de dados contendo o registro de dados específico com o qual você deseja estabelecer um vínculo.
AutoApplyDataGraphics Opcional Boolean Se um gráfico de dados deverá ser aplicado automaticamente às formas vinculadas. Consulte Comentários para obter mais informações.

Valor de retorno

Nada

Comentários

O método Shape.LinkToData funciona de modo bem semelhante ao mesmo método do objeto Selection, Selection.LinkToData, porém ele vincula uma única forma, e não uma seleção de formas, a uma única linha de dados.

Se você passar True para o parâmetro AutoApplyDataGraphics, o Microsoft Visio reaplicará o gráfico de dados existente a uma forma caso ela já tivesse um gráfico de dados aplicado antes da chamada do método. Para uma forma que anteriormente não tinha gráfico de dados, o Visio aplicará o gráfico de dados usado mais recentemente em qualquer outra forma no documento atual.

Exemplo

A macro a seguir do Microsoft Visual Basic for Applications (VBA) mostra como usar o método LinkToData para vincular uma forma a uma linha de dados.

Antes de executar esta macro, adicione pelo menos um conjunto de registos de dados à coleção DataRecordsets do documento. A macro usa a identificação do conjunto de registros de dados adicionado mais recentemente à coleção. Desenha uma forma de retângulo na página e liga-a aos dados na primeira linha do conjunto de registos de dados, ao mesmo tempo que aplica o gráfico de dados predefinido à 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

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.

  • Last updated on