Histórico da Página

...

Visão Geral
Procedures do Include ut-4gltreeview.i (facilitador)
Procedures e Funções do Componente
Exemplo de Utilização
Telas do TreeView
Documentação Complementar do Componente

...

Card documentos

Informacao	Não se esqueça de eliminar o treeview da memória no final do seu programa!!!
Titulo	IMPORTANTE!

03. PROCEDURES E FUNÇÕES DO COMPONENTE

O componente TreeView.w 4GLTreeView possui um código altamente documentado que pode ser utilizado.

...

Abaixo temos as principais procedures e funções do TreeView:

Procedure

Parâmetros

Descrição

Exemplo/Utilização

addNode *

Parâmetros	Tipo	Descrição
pcKe (I)	Char	Chave do node
pcKePar (I)	Char	Pai do node
pcLabel (I)	Char	Label do node
pcIco (I)	Char	Ícone do node
pcOptn (I)	Char	Parâmetros do node

Adiciona um node no treeview.

Se o node for adicionado a um

node pai, ele será o último filho.

DO ON ERROR UNDO, LEAVE:
   RUN addNode IN h-4gltreeview 
       ("n1","","node1","","").
   RUN addNode IN h-4gltreeview 
       ("n2","","node2","","expanded").
   RUN addNode IN h-4gltreeview 
       ("n21","n2","node21","","").
   RUN addNode IN h-4gltreeview 
       ("n22","n2","node22","","expanded").
   RUN addNode IN h-4gltreeview 
       ("n221","n22","node221","image/book02.bmp","").
   RUN addNode IN h-4gltreeview 
       ("n222","n22","node222","image/book02.bmp","").
   RUN addNode IN h-4gltreeview 
       ("n3","","node3","present1.bmp","expanded").
   RUN addNode IN h-4gltreeview 
       ("n31","n3","node31","image/$.bmp","").
   RUN addNode IN h-4gltreeview 
       ("n4","","node4","image/smile56.bmp","").
END.

applyEntry

Passar o parâmetro vazio ("")

Faz um entry no treeview

RUN applyEntry IN h-4gltreeview
    (INPUT "").

updateNode *

deleteNode

Parâmetro	Tipo	Descrição
pcKe (I)	Char	Chave do node a mover

pcOptn

pcFieldNames (I)

Char

Parâmetros do node

List de campos, exemplo: "lab,ico"
pcFieldValues (I)	Char	Lista de valores separados por chr(1)
pcOptn (I)	Char	Parâmetros do node

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

RUN deleteNodeupdateNode IN h-4gltreeview
    (c-codigo-node, "refresh").", "", cFgColor).

deleteNode

Parâmetro	Tipo	Descrição
pcKe (I)	Char	Chave do node
pcOptn (I)	Char	Parâmetros do node

Elimina um node de uma chave especificada.

RUN deleteNode IN h-4gltreeview
    (c-codigo-node, "refresh").

moveNode

Parâmetro	Tipo	Descrição
pcKe (I)	Char	Chave do node a mover
pcToKe (I)	Char	Mover para o node
pcMode (I)	Char	Modos possíveis: after, before, parent
pcOptn (I)	Char	Opção possível: refresh

Move um node origem como filho de outro node destino. Caso o pcMode = "parent" e o node destino seja em branco, ele jogara o node origem como o último node do nível 0.

RUN moveNode

destroyObjectElimina o treeview da memória.

IF  VALID-HANDLE(h-4gltreeview) THEN DO:

    RUN destroyObject IN h-4gltreeview.

    DELETE PROCEDURE h-4gltreeview.

END.

emptyTreeZera o conteúdo da treeview.

RUN emptyTree IN h-4gltreeview.

enableObjectHabilita o treeview

RUN enableObject IN h-4gltreeview.

expandBranch

Parâmetro	Tipo	Descrição
pcKe (I)	Char	Chave do node

Expande o node e todos os filhos dele

RUN expandBranch IN h-4gltreeview 
    (c-codigo-node).
RUN pi-atualizaTreeview.
, c-codigo-node-pai, "after", "refresh").

enableObject
Habilita o getFrameTreeview

Parâmetro	Tipo	Descrição
hFrame (O)	Handle	Handle da frame do treeview

Retorna o handle da frame do treeview

RUN getFrameTreeviewenableObject IN h-4gltreeview 
    (OUTPUT hFrameTV).

getNodeDetails

Parâmetro	Tipo	Descrição
pcKe (I)	Char	Chave do node

Retorna detalhes de um node do treeview

initializeObject
Inicializa o treeview

RUN initializeObject IN h-4gltreeview.

destroyObject
Elimina o treeview da memória.

IF  VALID-HANDLE(h-4gltreeview) THEN DO:

    RUN destroyObjectRUN getNodeDetails IN h-4gltreeview.

    DELETE PROCEDURE (c-codigo-node, OUTPUT hNdBf).h-4gltreeview.

END.

getFrameTreeview

Parâmetro	Tipo	Descrição
hFrame (O)	Handle	Handle da frame do treeview

Retorna o handle da frame do treeview

RUN getFrameTreeview IN h-4gltreeview 
    (OUTPUT hFrameTV).

emptyTree
Zera o conteúdo da treeview.

RUN emptyTree IN h-4gltreeview.

applyEntryPassar o parâmetro vazio ("")Faz um entry no treeview

RUN applyEntry IN h-4gltreeview
    (INPUT "").

expandBranch

Parâmetro	Tipo	Descrição
pcKe (I)	Char	Chave do node

Expande o node e todos os filhos dele

RUN expandBranch IN h-4gltreeview
    (c-codigo-node).
RUN pi-atualizaTreeview.

getNodeDetails

Parâmetro	Tipo	Descrição
pcKe (I)	Char	Chave do node

Retorna detalhes de um node do treeview

RUN getNodeDetails IN h-4gltreeview
    (c-codigo-node, OUTPUT hNdBf).

MESSAGE 
    "id:" hNdBf:BUFFER-FIELD("idMESSAGE 
    "id:" hNdBf:BUFFER-FIELD("id"):BUFFER-VALUE SKIP
    "label:" hNdBf:BUFFER-FIELD("lab"):BUFFER-VALUE SKIP
    "ico:" hNdBf:BUFFER-FIELD("ico"):BUFFER-VALUE SKIP
    "level:" hNdBf:BUFFER-FIELD("level"):BUFFER-VALUE SKIP
    "parent:" hNdBf:BUFFER-FIELD("par"):BUFFER-VALUE SKIP
    "prev-sib:" hNdBf:BUFFER-FIELD("pre"):BUFFER-VALUE SKIP
    "next-sib:" hNdBf:BUFFER-FIELD("nex"):BUFFER-VALUE SKIP
    "expand:" hNdBf:BUFFER-FIELD("expanded"):BUFFER-VALUE SKIP
    "optnlabel:" hNdBf:BUFFER-FIELD("optnlab"):BUFFER-VALUE SKIP
    VIEW-AS ALERT-BOX INFO BUTTONS OK.

DELETE OBJECT hNdBf.

initializeObjectInicializa o treeview

RUN initializeObject IN h-4gltreeview.

moveNode

Parâmetro	Tipo	Descrição
pcKe (I)	Char	Chave do node a mover
pcToKe (I)	Char	Mover para o node
pcMode (I)	Char	Modos possíveis: after, before, parent
pcOptn (I)	Char	Opção possível: refresh

Move um node origem como filho de outro node destino. Caso o pcMode = "parent" e o node destino seja em branco, ele jogara o node origem como o último node do nível 0.

RUN moveNode IN h-4gltreeview 
    (c-codigo-node, c-codigo-node-pai, "after", "refresh").

 "ico:" hNdBf:BUFFER-FIELD("ico"):BUFFER-VALUE SKIP
    "level:" hNdBf:BUFFER-FIELD("level"):BUFFER-VALUE SKIP
    "parent:" hNdBf:BUFFER-FIELD("par"):BUFFER-VALUE SKIP
    "prev-sib:" hNdBf:BUFFER-FIELD("pre"):BUFFER-VALUE SKIP
    "next-sib:" hNdBf:BUFFER-FIELD("nex"):BUFFER-VALUE SKIP
    "expand:" hNdBf:BUFFER-FIELD("expanded"):BUFFER-VALUE SKIP
    "optn:" hNdBf:BUFFER-FIELD("optn"):BUFFER-VALUE
    VIEW-AS ALERT-BOX INFO BUTTONS OK.

DELETE OBJECT hNdBf.

hasNodes

getTreeCount

getNodeParentKey

selectNode

collapseNode

expandNode

setNodeTag

getNodeTag

updateNode *

Parâmetro	Tipo	Descrição
pcKe (I)	Char	Chave do node a mover
pcFieldNames (I)	Char	List de campos, exemplo: "lab,ico"
pcFieldValues (I)	Char	Lista de valores separados por chr(1)
pcOptn (I)	Char	Parâmetros do node

Atualiza o label, ícone ou a lista de opções de um determinado node.RUN updateNode IN h-4gltreeview
(c-codigo-node, "", "", cFgColor).

Árvore de páginas

Versões comparadas

Versão antiga 25

Nova versão 26

Chave

03. PROCEDURES E FUNÇÕES DO COMPONENTE