Tag dataLink¶

A tag dataLink representa um componente não visual (não é exibido na interface) que monitora mudanças em um NodeDatabase.

Veja também:

Características¶

Propriedades e atributos¶

Propriedade	Tipo	Valor Padrão	Descrição
name	String	\<string vazio>	Define um nome para a componente. O nome deve ser único, isto é, dentro de um form, não é possível existir 2 controles com o mesmo nome. Se não for definido um nome para o controle no arquivo LFM, um nome único será gerado para ele em tempo de compilação. Nomear controles é especialmente útil quando se quer trabalhar com códigos LUA.
field	String	\<string vazio>	Caminho de um campo no NodeDatabase. Quando associado, o dataLink passa a monitorar mudanças no campo informado. Veja também: Lua Form e NodeDatabase NodeDatabase
fields	Arranjo de String	{} // \<arranjo vazio>	Idem à propriedade "field", porém permite monitorar mudanças em mais de um campo com um único dataLink. Observação: Não é possível utilizar as propriedades "fields" e "field" ao mesmo tempo, elas são mutualmente exclusivas.
defaultValue	String	\<String Vazio>	Quando definido, se o campo identificado pelo atributo "field" estiver vazio, ele será inicializado com este valor informado.
defaultValues	Arranjo de String	{} // \<arranjo vazio>	Idem à propriedade "defaultValue", porém permite definir valores padrões para cada um dos campos informado na propriedade "fields" Observação: Não é possível utilizar as propriedades "defaultValue" e "defaultValues" ao mesmo tempo pois elas são mutualmente exclusivas.

Eventos¶

Nome do evento	Descrição
onChange	Este evento é invocado quando ocorre uma mudança de valor no campo definido pela propriedade "field" ou quando ocorrer mudança de valor em algum dos campos definidos pela propriedade "fields" Parâmetros/Informações: field - string informando qual campo mudou oldValue - Antigo valor do campo newValue - Novo valor do campo Observações: Este evento pode ser invocado em qualquer uma destas ocasiões: Os dados do nodedatabase da ficha/form acabaram de ser carregados O usuário local alterou o valor de algum campo monitorado pelo dataLink Algum outro usuário remoto alterou algum dos campos monitrados pelo dataLink.
onPersistedChange	Este evento é invocado quando ocorre uma mudança de valor no campo definido pela propriedade "field" ou quando ocorrer mudança de valor em algum dos campos definidos pela propriedade "fields" no servidor. Parâmetros/Informações: field - string informando qual campo mudou oldValue - Antigo valor conhecido do campo no servidor. newValue - Novo valor do campo no servidor. Observações: Devido a existência de transações no NodeDatabase e também devido à característica assíncrona do NodeDatabase, o valor dos atributos do NodeDatabases podem, temporariamente, não refletir ao valor salvo no servidor e nem ao valor que os outros usuários remotos tem acesso. Este evento é chamado quando alguma alteração é confirmada no lado do Servidor, persistida e disponibilizada para todos os outros usuários remotos. O valor persistido pode ser obtido através da função NDB.getPersistedAttributeValue()
onUserChange	Este evento é invocado quando ocorre uma mudança de valor no campo definido pela propriedade "field" ou quando ocorrer mudança de valor em algum dos campos definidos pela propriedade "fields" porque o usuário local alterou o conteúdo do do campo, seja editando ele visualmente ou através de código Lua. Parâmetros/Informações: field - string informando qual campo mudou oldValue - Antigo valor do campo newValue - Novo valor do campo. Observações: Lembre-se, este evento será disparado apenas quando o usuário local alterar o valor de algum dos campos monitorados pelo dataLink.
onChildAdded	Este evento é invocado quando um objeto nodo filho é criado dentro do field que está sendo monitorado (se o campo for um nodo). Parâmetros: node - O objeto nodo filho que foi criado.
onChildRemoved	Este evento é invocado quando um objeto nodo filho é removido de dentro do field que está sendo monitorado (se o campo for um nodo). Parâmetros: node - O objeto nodo filho que foi removido.

Veja Tratando eventos do Lua Form

Exemplos:¶

Exemplo 1 - Calculando um modificador de atributo de D\&D¶

\<?xml version="1.0" encoding="UTF-8"?> ** **\<form name="frmFichaTeste"> \ \<layout left="20" top="20" height="25" width="125"> \<label align="left" text="Força: " autoSize="true"/> \<edit align="client" horzTextAlign="center" field="atributoForca"/> \ \<label align="right" width="30" field="modificadorForca" horzTextAlign="center"/> \</layout> \ \<dataLink field="atributoForca"> \<event name="onChange"> local valorForca = tonumber(sheet.atributoForca); if (valorForca ~= nil) then sheet.modificadorForca = math.floor(valorForca / 2) - 5; if sheet.modificadorForca > 0 then sheet.modificadorForca = "+" .. sheet.modificadorForca; end; else sheet.modificadorForca = nil; end \</event> \</dataLink> \</form>

Neste exemplo, ligamos um edit ao campo "atributoForca" e um label ao campo "modificadorForca"... Usamos um dataLink para monitorar mudanças em "atributoForca" para calcularmos e salvamos o modificador no campo "modificadorForca" (para que o label possa exibir o valor).

Veja também:

Exemplo 2 - Somando dois campos na interface¶

\<?xml version="1.0" encoding="UTF-8"?> \<form name="frmFichaTeste"> \ \<layout left="20" top="20" height="25" width="200"> \<edit field="parcela1" align="left" horzTextAlign="center" width="50"/> \<label align="left" text=" + " autoSize="true"/> \<edit field="parcela2" align="left" horzTextAlign="center" width="50"/> \<label align="left" text=" = " autoSize="true"/> \ \<label align="client" field="resultadoSoma" horzTextAlign="center"/> \</layout> \ \<dataLink fields="{'parcela1', 'parcela2'}"> \<event name="onChange"> sheet.resultadoSoma = (tonumber(sheet.parcela1) or 0) + (tonumber(sheet.parcela2) or 0); \</event> \</dataLink> \</form>

Neste exemplo, usamos o dataLink para monitorar dois campos ao mesmo tempo: "parcela1" e "parcela2"

Veja também:

Created with the Personal Edition of HelpNDoc: Revolutionize your documentation process with HelpNDoc's online capabilities