|
<< Clique para Mostrar o Sumário >>
CreateLink |
CreateLink(Property, Source, [BindType])
Este método permite criar uma Associação com uma propriedade de um objeto. Em caso de sucesso, este método retorna o objeto criado. Caso contrário, ocorre um erro de script e o método retorna Nothing. Este método possui os parâmetros Property, que especifica o nome da propriedade para a qual é criada a Associação, Source, que especifica o nome do objeto de origem da Associação, e BindType, que é opcional e especifica o tipo de Associação a ser criada. Se este parâmetro é omitido, cria uma Associação Simples.
NOTA |
Nem todas as propriedades existentes em um objeto permitem a criação de Associações. Para verificar quais as propriedades permitem este recurso, acesse a aba Associações da Janela de Propriedades do objeto. Se a propriedade é inválida para uma Associação, não existir ou já possuir uma Associação, ocorre um erro de script. |
Opções disponíveis para o parâmetro BindType
Opção |
Descrição |
|---|---|
0 - Associação Simples |
Na Associação Simples, o valor da origem é copiado para a propriedade toda vez que é modificado |
1 - Associação Bidirecional |
Na Associação Bidirecional ocorre o mesmo que na Simples, mas caso haja uma variação na propriedade, o valor é copiado para a origem, gerando assim uma Associação de duas direções |
2 - Associação Analógica |
A Associação Analógica estabelece uma escala de conversões entre a variável de origem e a propriedade |
3 - Associação Digital |
Na Associação Digital são especificados valores fixos ou alternantes para a propriedade, que são atribuídos de acordo com a fonte ser verdadeira ou falsa |
4 - Associação por Tabela |
Na Associação por Tabela pode-se estabelecer condições entre a variável, os valores e o destino. Na tabela são especificados os valores mínimos e máximos e demais configurações |
5 - Associação Reversa |
A Associação Reversa é uma Associação unidirecional da propriedade para a fonte |
6 - Associação Múltipla |
A Associação Múltipla é semelhante a uma Associação por Tabela, exceto que cada linha da Associação permite buscar seu valor de uma fonte diferente |
No exemplo a seguir, clicar no Botão de Comando cria uma Associação Bidirecional para o valor de um Tag Interno no objeto Texto1, ou seja, configura o parâmetro BindType para o valor 1 (um).
Sub CommandButton1_Click()
On Error Resume Next
Dim bndType, bndValue
bndType = 1 'Associação Bidirecional
Set bndValue = Screen.Item("Texto1").Links.Item("Value")
If bndValue Is Nothing Then
MsgBox "Criando uma Associação Bidirecional"
Set bndValue = Screen.Item("Texto1").Links.CreateLink("Value", "Dados.TagInterno1.Value", bndType)
Else
MsgBox "Texto1 já tem uma Associação para " & bndValue.Source
End If
End Sub