Propriedade DataRecordset.LinkReplaceBehavior (Visio)

Obtém os vínculos existentes entre formas e linhas de dados ou define como esses vínculos são manipulados quando são chamados os métodos que vinculam as formas aos dados. Leitura/gravação.

Sintaxe

expressão. LinkReplaceBehavior

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

Valor de retorno

VisLinkReplaceBehavior

Comentários

As seguintes constantes para comportamentos de substituição de ligações são declaradas pela biblioteca de tipos do Visio no VisLinkReplaceBehavior :

Essas opções correspondem àquelas disponíveis na caixa de diálogo Propriedades da guia correspondente ao conjunto de registros de dados na janela Dados Externos. (Na janela Dados Externos, na guia do conjunto de registros de dados, clique no botão direito do mouse, aponte para Fonte de Dados e, em seguida, clique em Propriedades.)

Os métodos afetados por esta definição de propriedade incluem Selection.LinkToData, Shape.LinkToData e Selection.AutomaticLink.

Na IU, quando os utilizadores tentam ligar a formas de dados que têm ligações existentes para dados e a definição é visLinkReplacePrompt, o Visio responde ao abrir uma caixa de diálogo para informar os utilizadores de que as suas ações irão interromper as ligações existentes e perguntar se querem continuar. Uma vez que abrir uma caixa de diálogo não é uma resposta adequada a uma chamada de método, quando liga formas ao chamar qualquer um destes métodos, o Visio trata a definição visLinkReplacePrompt como se fosse visLinkReplaceAlways. Ou seja, estas duas definições diferem na forma como afetam o comportamento na IU, mas não no comportamento programático. A predefinição é substituir sempre as ligações existentes quando a ligação é efetuada programaticamente, mas para perguntar quando a ligação é executada na IU.

Quando LinkReplaceBehavior está definido como visLinkReplaceNever, ambos os métodos LinkToData são desativados e as chamadas para os mesmos falham.

A definição LinkReplaceBehavior também afeta a predefinição da caixa de marcar Substituir Ligações Existentes no segundo ecrã do assistente Ligação Automática na IU do Visio (no separador Dados, clique em Ligação Automática). Se LinkReplaceBehavior estiver definido como visLinkReplaceAlways ou visLinkReplacePrompt, esta caixa está selecionada por predefinição. Se a propriedade LinkReplaceBehavior estiver definida como visLinkReplaceNever, a caixa de marcar é desmarcada por predefinição. Os utilizadores podem alterar o comportamento predefinido do assistente ao selecionar ou desmarcar a caixa de marcar.

Além disso, a definição LinkReplaceBehavior determina como funciona o método Selection.AutomaticLink . Como é o caso dos métodos LinkToData , quando LinkReplaceBehavior está definido como visLinkReplaceAlways ou visLinkReplacePrompt, a Ligação Automática substitui as ligações existentes. Quando LinkReplaceBehavior está definido como visLinkReplaceNever, a Ligação Automática não substitui as ligações existentes.

No entanto, a diferença entre os métodos LinkToData e o método AutomaticLink é que, para a Ligação Automática, pode substituir a definição LinkReplaceBehavior ao transmitir as visAutoLinkReplaceExistingLinks ou a constante visAutoLinkDontReplaceExistingLinks da enumeração VisAutoLinkBehaviors para o método como parâmetro AutoLinkBehavior.

Por exemplo, se LinkReplaceBehavior estiver definido como visLinkReplaceNever, pode especificar que a Ligação Automática substitui as ligações existentes ao transmiti-la visAutoLinkReplaceExistingLinks.

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.