Tag dataScopeBox¶

A tag/componente dataScopeBox funciona como a tag layout, porém permite definir em qual objeto Nodo seus controles salvarão/lerão os dados (NodeDatabase);

Após definir o nodo escopo, todos os componentes visuais que estão dentro desta tag passarão a ler e salvar os dados neste nodo.

Saiba mais sobre escopo de dados do NodeDatabase em Lua Form e NodeDatabase.

Atenção: A tag popup não é capturada pelo escopo de dados definido pelo dataScopeBox.

Herança¶

O dataScopeBox possui todas as características de uma tag layout.

Veja:

Características¶

Além das características herdadas, o dataScopeBox possui também as seguintes características:

Propriedades¶

Propriedade	Tipo	Valor Padrão	Descrição
scopeNode, nodeObject ou node	Objeto Nodo	nil	Define em qual objeto nodo de um NodeDatabase os controles de edição deste dataScopeBox devem salvar os dados. Observações: Se for nil, os controles dentro desta tag que salvam/carregam dados no NodeDatabase ficam desabilitados. Só é possível alterar esta propriedade utilizando código Lua. Veja também: NodeDatabase Escopo de Dados

Métodos¶

É possível invocar métodos dos controles usando código LUA.

Método	Descrição
dataScopeBox:setNodeObject(nodeObject)	Método alternativo para alterar a propriedade "scopeNode"
dataScopeBox:getNodeObject();	Método alternativo que retorna o valor da propriedade "scopeNode"

Eventos da tag dataScopeBox¶

Nome do evento	Descrição
onNodeReady	Este evento é invocado quando o objeto nodo de um NodeDatabase associado a este dataScopeBox está pronto para ser usado. Quando este evento é chamado, você pode assumir: a propriedade "node" do dataScopeBox está diferente de nil e possui uma referência válida para um objeto nodo. O processo de carregamento do nodeDatabase associado já chegou ao fim. Você já consegue acessar os dados armazenados nele normalmente.
onNodeUnready	Este evento é invocado quando o objeto nodo de um NodeDatabase associado a este dataScopeBox deixa de estar pronto para ser usado. Quando este evento é chamado, você pode assumir: a propriedade "node" do dataScopeBox não contém mais uma referência válida para um objeto nodo.
onNodeChanged	Este evento é invocado um objeto nodo de um NodeDatabase é associado ou desassociado a este dataScopeBox. Ver NodeDatabase

Veja também Tratando eventos do Lua Form.

¶

Exemplos:¶

Exemplo 1 - Lista com Painel de Detalhes¶

Veja o tutorial Criar uma lista dinâmica + painel de detalhes para ver o exemplo completo .

Created with the Personal Edition of HelpNDoc: Full-featured Kindle eBooks generator