Partilhar via


Método Shape.BreakLinkToData (Visio)

Quebra o vínculo entre a forma e a linha de dados à qual está vinculada no conjunto de registros de dados especificado.

Observação

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

Sintaxe

expression. BreakLinkToData( _DataRecordsetID_ )

Expressão Uma expressão que retorna um objeto Shape .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
DataRecordsetID Obrigatório Long A identificação do conjunto de registros de dados contendo a linha de dados à qual a forma está vinculada.

Valor de retorno

Nada

Comentários

A quebra do vínculo entre uma forma e uma linha de dados não remove os dados da forma (chamados de propriedades personalizadas em algumas versões anteriores do Visio) nem os gráficos de dados associados à forma.

Exemplo

A macro a seguir do Microsoft Visual Basic for Applications (VBA) mostra como usar o método BreakLinkToData para quebrar o vínculo entre uma forma e uma linha de dados de um conjunto de registros de dados.

Antes de executar essa macro, coloque uma forma na página, adicione pelo menos um conjunto de registros de dados à coleção DataRecordsets do documento e use qualquer método de vinculação para vincular a forma a uma linha de dados no conjunto de registros de dados que você adicionou mais recentemente à coleção. Você também pode vincular a forma a uma linha de dados arrastando a linha a partir da janela Dados Externos para a forma na interface do usuário do Visio. Em seguida, selecione a forma vinculada.

Public Sub BreakLinkToData_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 = ActiveWindow.Selection.PrimaryItem 
    vsoShape.BreakLinkToData (vsoDataRecordset.ID) 
    
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.