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

expressão. LinkReplaceBehavior

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

Valor de retorno

VisLinkReplaceBehavior

Comentários

As constantes a seguir para comportamentos de substituição de link são declaradas pela biblioteca de tipos do Visio no 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	Solicitar ao usuário antes de substituir links quando o usuário tentar criar links na interface do usuário (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-se 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 quebrarão os links existentes e perguntarão se eles querem prosseguir. 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 links existentes quando a vinculação é executada de forma programática, mas para solicitar 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 seleção Substituir Links Existentes na segunda tela do assistente link automático 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 seleção será limpa por padrão. Os usuários podem alterar o comportamento padrão do assistente selecionando ou desmarcando a caixa de seleçã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, AutomaticLink substitui links existentes. E quando LinkReplaceBehavior é definido como visLinkReplaceNever, o 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 enumeração visAutoLinkReplaceExistingLinks ou a constante visAutoLinkDontReplaceExistingLinks da enumeração VisAutoLinkBehaviors para o método como o parâmetro AutoLinkBehavior.

Portanto, por exemplo, se LinkReplaceBehavior estiver definido como visLinkReplaceNever, você poderá especificar que o AutomaticLink , no entanto, substitui 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.