Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

ProcedureParâmetrosDescriçãoExemplo/Utilização
pi-create-node
I
ParâmetrosTipoDescrição
IpcKeCharChave do node
pcKeParCharPai do nodeI
pcLabelCharLabel do nodeI
pcIcoCharÍcone do node
IpcOptnCharParâmetros do node



Cria um node no treeview.

O pcOptn é uma lista de parâmetros que são separados por chr(1).

Valores válidos para o pcOtn:

ParâmetroDescrição
expandedInicia o node expendido
collapsedInicia o node fechado (não expandido) - opção default
selectedSeleciona o node ate o próximo refresh
refreshRealiza o refresh do treeview
AutoSort=yes/noLiga ou desliga a ordenação do treeview
font=nDefine uma fonte para o node
fgcolor=nDefine uma cor de frente para o node
bgcolor=nDefine uma cor de fundo para o node
tooltip=xxxDefine um help para o node
DO ON ERROR UNDO, LEAVE:
    RUN pi-create-node 
("n1","","node 1","","") NO-ERROR.
    RUN pi-create-node 
("n2","","node 2","","expanded") NO-ERROR.
END.
pi-update-node
I
ParâmetroTipoDescrição
pcKeCharChave do node a mover
IpcFieldNamesCharLista de campos, exemplo: "lab,ico"I
pcFieldValuesCharLista de valores separados por chr(1)I
pcOptnCharParâmetros do node

Atualiza o label, ícone ou a lista de opções de um determinado node.

Para remover um item do pcOptn existente, coloque "!" na frente da opção, conforme o exemplo abaixo:

pcOptn="!font"

A opção acima removerá o fonte definido para o node.

ASSIGN cFgColor = "font=1".
RUN pi-update-node
(c-codigo-node, "", "", cFgColor) NO-ERROR.
pi-node-is-expanded
ParâmetroTipoDescrição
I
pcKeCharChave do node

Retorno "YES" ou "NO" indicando se o node está expandido.

RUN pi-node-is-expanded (INPUT c-codigo-node).
IF RETURN-VALUE = "YES" THEN
 MESSAGE "O NÓ ESTÁ EXPANDIDO"
VIEW-AS ALERT-BOX.
ELSE
  MESSAGE "O NÓ NÃO ESTÁ EXPANDIDO"
VIEW-AS ALERT-BOX.
pi-atualizaTreeview
Faz uma atualização/refresh do TreeView.
RUN pi-atualizaTreeview.
tvNodeEvent
I
ParâmetroTipoDescrição
pcEventCharEvento que aconteceu
IpcNodeKeyCharChave do node

Procedure auxiliar que é assinada no treeviewTreeView, onde todos os eventos que ocorrerem no treeview TreeView chamarão esta procedure.

Você não precisa chamar esta procedure diretamente, pois quem irá chamá-la é o treeviewTreeView.

Nesta procedure serão alimentados as variáveis será alimentada a variável c-codigo-node e h-node com o pcNodeKey, que é com a chave do node selecionado.

pi-atualizaTreeviewFaz uma atualização/refresh do treeview

.


RUN pi-atualizaTreeview.pi-ClickTreeview
Esta é uma procedure que é

Procedure que será chamada pelo tvNodeEvent

e deve ser criada no seu programa, pois neste ponto que você deverá utilizar o

sempre que ocorrer um evento de "select" (click em um node) no TreeView.

Caso queria capturar este evento, esta Procedure deve ser definida no seu programa.

A variável c-codigo-node

e h-node, que é a chave do node, e fazer os seus procedimentos necessários para atualizar frames e utilizar o

irá conter a chave do node selecionado.

PROCEDURE pi-ClickTreeView:
MESSAGE "Chave do Nó: " + c-codigo-node
VIEW-AS ALERT-BOX.
END PROCEDURE.
pi-CtrlPopupTreeview
ParâmetroTipoDescrição
pcActionChar

Ação do Popup:

"build" ou "choose"

pcEventCharItem do Popup escolhido
pcNodeKey
Chave do node

Procedure utilizada para criar e controlar o Popup do Treeview.

Ela será chamada pelo tvNodeEvent em dois momentos:

1) Criação do Menu

Executada na momento em que o componente é criado. Passando como parâmetro o Ação "build". Neste momento a Procedure deverá retornar uma String com a lista dos itens que devem ser apresentados no Popup. A lista deve utilizar o separador "chr(1)" e deve ser composta por Label e Valor de cada item. Ex: "LabelItem1" + chr(1) + "valoritem1" + chr(1) + "LabelItem2" + chr(1) + "valoritem2". É possível acrescentar uma regra entre os itens, para isto, basta incluir um item com o Label "RULE" e o  valor igual a branco.

xxxxProcedure que será chamada pelo tvNodeEvent sempre que ocorrer um evento de "select" (click em um node) no TreeView.

xxxxCaso queria capturar este evento, esta Procedure deve ser definida no seu programa.

xxxxxA variável c-codigo-node irá conter a chave do node selecionado.


pi-GenericEventTreeview
ParâmetroTipoDescrição
pcEventCharEvento que aconteceu
pcNodeKeyCharChave do node

xxxxProcedure que será chamada pelo tvNodeEvent sempre que ocorrer um evento de "select" (click em um node) no TreeView.

xxxxCaso queria capturar este evento, esta Procedure deve ser definida no seu programa.

xxxA variável c-codigo-node irá conter a chave do node selecionado.



Card documentos
InformacaoVocê tem que criar a pi-ClickTreeview quando utilizar o ut-treeview.i, senão ocorrerá erro durante a execução do seu programa.
TituloIMPORTANTE!

...