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.

Observação

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

Sintaxe

mais simples. LinkReplaceBehavior

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

Valor de retorno

VisLinkReplaceBehavior

Comentários

As seguintes constantes para comportamentos de substituição de link são declaradas pela biblioteca de tipos do Visio em VisLinkReplaceBehavior :

Constant	Valor	Descrição
visLinkReplaceAlways	1	Sempre substituir os vínculos quando vincular a uma forma que já tem vínculos
visLinkReplaceNever	0	Nunca substituir os vínculos quando vincular a uma forma que já tem vínculos
visLinkReplacePrompt	2	Avise o usuário antes de substituir links quando o usuário tentar criar links na IU (interface do usuário) do Visio.

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 essa configuração de propriedade incluem Selection.LinkToData, Shape.LinkToData e Selection.AutomaticLink.

Na interface do usuário, quando os usuários tentam vincular a formas de dados que têm links existentes para dados e a configuração é visLinkReplacePrompt, o Visio responde abrindo uma caixa de diálogo para informar aos usuários que suas ações interromperão os links existentes e pergunta se eles desejam continuar. Como abrir uma caixa de diálogo não é uma resposta apropriada a uma chamada de método, quando você vincula formas chamando qualquer um desses métodos, o Visio trata a configuração visLinkReplacePrompt como se fosse visLinkReplaceAlways. Ou seja, essas duas configurações diferem em como afetam o comportamento na interface do usuário, mas não o comportamento programático. O padrão é sempre substituir os links existentes quando a vinculação é executada programaticamente, mas avisar quando a vinculação é executada na interface do usuário.

Quando LinkReplaceBehavior é definido como visLinkReplaceNever, ambos os métodos LinkToData são desabilitados e as chamadas para eles falham.

A configuração LinkReplaceBehavior também afeta a configuração padrão da caixa de marca Substituir Links Existentes na segunda tela do assistente de Vinculação Automática na interface do usuário do Visio (na guia Dados, clique em Vincular Automaticamente). Se LinkReplaceBehavior estiver definido como visLinkReplaceAlways ou visLinkReplacePrompt, essa caixa será selecionada por padrão. Se a propriedade LinkReplaceBehavior estiver definida como visLinkReplaceNever, a caixa de marcação será desmarcada por padrão. Os usuários podem alterar o comportamento padrão do assistente marcando ou desmarcando a caixa de marcação.

Além disso, a configuração LinkReplaceBehavior determina como o método Selection.AutomaticLink funciona. Como é o caso dos métodos LinkToData , quando LinkReplaceBehavior é definido como visLinkReplaceAlways ou visLinkReplacePrompt, o AutomaticLink substitui os links existentes. E quando LinkReplaceBehavior é definido como visLinkReplaceNever, AutomaticLink não substitui os links existentes.

A diferença entre os métodos LinkToData e o método AutomaticLink , no entanto, é que, para AutomaticLink, você pode substituir a configuração LinkReplaceBehavior passando a constante visAutoLinkReplaceExistingLinks ou visAutoLinkDontReplaceExistingLinks da enumeração VisAutoLinkBehaviors para o método como o parâmetro AutoLinkBehavior.

Assim, por exemplo, se LinkReplaceBehavior estiver definido como visLinkReplaceNever, você poderá especificar que AutomaticLink , no entanto, substitua os links existentes passando-o 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.