Manual | Início Anterior Próximo

TreeView Manual

Com o componete TreeView o desenvolvedor poderá criar menus de índices que possuam uma funcionalidade semelhante à hierarquia de diretórios que é exibida pelo Windows Explorer. Eles são fáceis de usar e mais fáceis ainda de criar (isso se estiver usando o WebIntegrator). Visualmente, a saída do componente TreeView será algo semelhante com o que segue abaixo:

O exemplo de TreeView gerado acima possui apenas dois níveis hierárquicos sendo que o último nível é sempre considerado como nível de detalhe pois a partir dele não há mais ramificações. Além das definições que são feitas diretamente pelo WI Builder, o componente TreeView oferece outras propriedades que podem ser alteradas pelo desenvolvedor. No momento em que as definições são gravadas, o WebIntegrator inseri no código-fonte da página WSP tags HTML que farão com que o TreeView seja montado e em uma dessas tags estão essas propriedades adicionais que o TreeView possui, a saber:

Propriedade

Descrição
UniqueID
Propriedade que contém o identificador único para esse TreeView. Recomenda-se não alterar o valor dessa propriedade.
DocRoot
Propriedade que informa o diretório-base a ser levado em consideração nos links do TreeView.
ImgRoot
Propriedade que informa o diretório onde está instalada a "pele" que está sendo usada pelo TreeView. O componente TreeView possui atualmente 4 tipos de "peles":

· |

· |

· |

· |

FrameSet
Propriedade que indica o nome da página que contém o FRAMESET, caso algum esteja sendo usado. Se o TreeView não fizer parte de um FRAMESET defina essa propriedade com uma string vazia ("").
ImgWidth
Propriedade que define a largura padrão das imagens exibidas pelo TreeView. Recomenda-se não alterar o valor dessa propriedade.
ImgHeight
Propriedade que define a altura padrão das imagens exibidas pelo TreeView. Recomenda-se não alterar o valor dessa propriedade.
EntryHeight
Recomenda-se não alterar o valor dessa propriedade.
InitialKey
Propriedade que define o valor inicial da chave usada internamente pelo TreeView. Recomenda-se não alterar o valor dessa propriedade.
CurrPageBG
Propriedade que define o valor da cor de background da página onde será exibido o TreeView.
CurrPageFG
Propriedade que define o valor da cor de foreground da página onde será exibido o TreeView.
LinkCurrPage
Propriedade que indica se os links serão para a própria página onde está sendo exibido o TreeView.
TreeRootHint
Propriedade que define o texto a ser apresentado como dica do nó raiz do TreeView.
NormalPageHint
Propriedade que define o texto a ser apresentado como dica de um link para uma página.
LinkedPageHint
Propriedade que define o texto a ser apresentado como dica de um link.
OpenBookHint
Propriedade que define o texto a ser apresentado como dica da figura que fecha um ramo da árvore do TreeView.
ClosedBookHint
Propriedade que define o texto a ser apresentado como dica da figura que abre um ramo da árvore do TreeView.
OpenBookStatus
Propriedade que define o texto a ser apresentado na barra de status do browser em relação à figura que fecha um ramo da árvore do TreeView.

ClosedBookStatus | Propriedade que define o texto a ser apresentado na barra de status do browser em relação à figura que abre um ramo da árvore do TreeView.
window.defaultStatus | Propriedade que define a mensagem que aparece na barra de status do browser.
navExplain | Propriedade que define a mensagem a ser exibida quando o TreeView não fizer parte de um FRAMESET e a propriedade checkFrames estiver setada para true.
FontFace | Propriedade que define a listagem das fontes a serem usadas pelo TreeView. Os nomes das fontes devem estar separados por vírgula.
compactTree | Propriedade que indica se a árvore que simboliza o TreeView será exibida numa forma compacta.
viewMatchCnt |
singleBranch | Propriedade que indica se apenas será visualizado um ramo extendido da árvore, ou seja, caso o usuário tente abrir um outro ramo da árvore e um já esteja aberto, esse último será fechado antes que o outro se ja expandido caso esta propriedade esteja definida como true.
checkFrames | Propriedade que indica se será feita a verificação se o TreeView faz parte de um FRAMESET.
baseHref | Propriedade que indica o nome do target dos links do TreeView, ou seja, o local onde será exibido o recurso para o qual o link aponta.

O campo Condição contém a expressão condicional a ser testada para saber se o componente deverá ser processado. Para saber maiores detalhes sobre as possíveis construções de condições clique aqui.
O campo Descrição serve para que o desenvolvedor da aplicação escreva um breve comentário sobre a ação a ser executada pelo componente em questão.
O campo Inserir Definição JS indica se o arquivo de definição JavaScript deverá ser colocado na página. Recomenda-se que na primeira vez que se esteja definindo um treeview esta opção esteja marcada.
O campo Link(||¹) define qual será a ação do link podendo ser uma chamada a uma função JavaScript, um endereço de uma página a ser chamada, etc. O link apenas será aplicado ao último nível da hierarquia.
O campo Nós exibe os textos dos nós a serem visualizados pelo TreeView. Note que os textos estão dispostos de uma forma hierárquica semelhante àquela que será exibida quando em execução pelo TreeView.
O desenvolvedor pode a qualquer momento alterar a posição de um nó nesta hierarquia subindo ou descendo tanto no sentido horizontal quanto no vertical e também remover ou adicionar uma nova opção em qualquer posição.
Toda vez que se desloca um nó para esquerda ou direita esse nó estará subindo ou descendo, respectivamente, um nível na hierarquia.
O campo Objeto define o nome do objeto que será inserido na sessão do usuário após a execução do componente, a depender do componente o objeto poderá possuir uma série de atributos e métodos. Por exemplo, o objeto definido em componentes do tipo Objeto possuem os métodos size() e columnNames() além de uma série de atributos representados pelos nomes das colunas vindas do resultado da consulta ao banco de dados.
No caso de um objeto declarado na definição de um web service esse objeto irá conter os parâmetros de resposta que serão retornados após a execução da chamada ao web service. Para saber quais os possíveis atributos e métodos de um objeto leia a documentação específica do componente.
O campo Texto(||¹) define o texto a ser exibido no nível da hierarquia que se encontra atualmente selecionado.
O campo Título(||¹) serve para definir qual será o texto que será exibido como título do TreeView.