Gerenciamento de Itens Globais

Modelo de Dados

../_images/model_dados2.jpg

GlobalTextLists

A partir da versão 1.0.08 instâncias de GlobalTextLists podem ser criadas dinamicamente no Kernel e no IDE através da API Lua. Note que, após o Viewer obter o projeto do Kernel, o mesmo não terá mais acesso às novas instâncias de GlobalTextLists que forem criadas no Kernel. Da mesma forma, instâncias de GlobalTextLists que forem criadas dinamicamente no Viewer, só serão visíveis neste Viewer durante a sessão de execução, pois não são persistidas no projeto nem enviadas para o Kernel.

No IDE, este recurso pode ser útil para se criar no projeto listas de textos a partir do acesso a um banco de dados externo. Neste caso, o projeto pode ser salvo manualmente pelo usuário do IDE para persistir os itens recém criados.

objTextList = Globals.GetTextList(string textListPath)

Descrição:

  • Retorna um objeto lista de texto.

Parâmetros de entrada:

  • textListPath - string com o caminho até a lista de texto

Parâmetros de saída:

  • instTextList - Instância de lista de texto. Se a instãncia não existe retorna nil.

Exemplo de utilização:

-- Retorna instância de lista de texto de nome Lista1 localizada dentro de "Grupo001"
local textlist = Globals.GetTextList("Grupo001.Lista1")

txtListTable = objTextlist:AsTable()

Descrição:

  • Transforma instância de TextList em Tabela Lua.

Exemplo de utilização:

local textlist = Globals.GetTextList("grupo.g1")
for text,value in pairs(textlist:AsTable()) do
  print(text .. "->" .. value)
end

int err = textList:Clear()

Descrição:

  • Limpa entradas na lista de texto

Parâmetros de saída:

  • Código de retorno associado à execução da função, onde 0 (zero) indica execução com sucesso da função, caso contrário indica um código de falha na execução da função.

Exemplo de utilização:

-- retorna instância de lista de texto de nome Lista1 localizada dentro de "Grupo001"
local textlist = Globals.GetTextList("Grupo001.Lista1")

erro = textlist:Clear() -- limpa entradas da lista de texto.

int error = textList:AddText(string text, int value)

Descrição:

  • Insere entrada (texto/valor) na lista

Parâmetros de entrada:

  • text - string com o texto associado ao valor

  • value - inteiro associado ao texto

Parâmetros de saída:

  • Código de retorno associado a execução da função, onde 0 (zero) indica execução com sucesso da função, caso contrário indica um código de falha na execução da função.

Exemplo de utilização:

-- retorna instancia de lista de texto de nome Lista1 localizada dentro de "Grupo001"
local textlist = Globals.GetTextList("Grupo001.Lista1")

erro = textlist:Clear() -- limpa entradas da lista de texto.

erro = textlist:AddText("texto001", 10) -- insere valor e texto "texto001"
erro = textlist:AddText("texto002", 20) -- insere valor e texto "texto002"