Table of contents
TOC
Recolher sumário
Expandir sumário

Método Shape.BreakLinkToData (Visio)Shape.BreakLinkToData Method (Visio)

office 365 dev account|Última Atualização: 22/03/2018
|
2 Colaboradores

Quebra o vínculo entre a forma e a linha de dados à qual está vinculada no conjunto de registros de dados especificado.Breaks the link between the shape and the data row to which it is linked in the specified data recordset.

Observação Este objeto do Visio ou membro está disponível somente para usuários licenciados do Visio Professional 2013.Note This Visio object or member is available only to licensed users of Visio Professional 2013.

SintaxeSyntax

expressão . BreakLinkToData ( DataRecordsetID )expression . BreakLinkToData( DataRecordsetID )

expressão Uma expressão que retorna um objeto Shape .expression An expression that returns a Shape object.

ParâmetrosParameters

NomeNameObrigatório/opcionalRequired/OptionalTipo de dadosData TypeDescriçãoDescription
DataRecordsetIDDataRecordsetIDObrigatórioRequiredLongLongA identificação do conjunto de registros de dados contendo a linha de dados à qual a forma está vinculada.The ID of the data recordset containing the data row the shape is linked to.

Valor retornadoReturn Value

NadaNothing

ComentáriosRemarks

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.Breaking the link between an shape and a data row does not remove shape data (called custom properties in some previous versions of Visio) from the shape, nor does it remove any data graphics associated with the shape.

ExemploExample

Os seguintes Microsoft Visual Basic for Applications (VBA) macro mostra como usar o método BreakLinkToData para quebrar o vínculo entre uma forma e uma linha de dados em um conjunto de registros de dados.The following Microsoft Visual Basic for Applications (VBA) macro shows how to use the BreakLinkToData method to break the link between a shape and a data row in a data recordset.

Antes de executar essa macro, coloque uma forma na página Adicionar pelo menos um conjunto de registros de dados à coleção DataRecordsets do documento e usar qualquer método de vinculação para vincular a forma a uma linha de dados de registros de dados que você mais recentemente adicionado à coleção. Como alternativa, você pode vincular a forma a uma linha de dados arrastando a linha da janela Dados externos para a forma na interface do usuário do Visio. Selecione a forma vinculada.Before running this macro, place a shape on the page, add at least one data recordset to the DataRecordsets collection of the document, and use any linking method to link the shape to a data row in the data recordset you most recently added to the collection. Alternatively, you could link the shape to a data row by dragging the row from the External Data window onto the shape in the Visio user interface. Then select the linked shape.

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
© 2018 Microsoft