Árvore
O componente Árvore é utilizado para mostrar dados em formato hierárquico. Suporta vínculo com entidades (tabelas e visões) que tenham autorrelacionamento, independentemente do nível do autorelacionamento.
Observação: Os símbolos 
(abrir ramificação) e 
(fechar ramificação) são utilizados para mostrar e ocultar os itens ou pastas de uma pasta, respectivamente nessa ordem.
O componente fica navegável, se a barra de navegação do formulário não estiver ativa ou quando o formulário estiver em modo de inserção ou alteração.
Aos eventos que são passados automaticamente para o fluxo associado ao componente:
Todo fluxo de ação associado em qualquer um dos eventos deste componente recebe dois parâmetros automáticos. E para que esses parâmetros sejam obtidos corretamente pelo fluxo de ação, quando este for executado no Webrun, é necessária a criação de dois parâmetros de entrada (no fluxo de ações): o primeiro parâmetro pode ser chamado de Campo-Chave (nome opcional - correspondendo ao código da pasta (valor da propriedade Campo-Chave) e o segundo parâmetro pode ser chamado de Campo Pai (nome opcional - correspondendo ao valor do código do proprietário do Campo-Chave (valor da propriedade Campo Pai).
Acesse um exemplo Utilizando o componente Árvore.
Observações:
-
Ao utilizar filtros dinâmicos em uma consulta vinculada ao componente árvore, ao navegar entre os registros, o Webrun atualizará constantemente o componente verificando se a variável informada sofreu modificação.
-
A propriedade Descrição não possui efeitos visuais no Webrun para o componente Árvore.
-
Este recurso está disponível apenas para a versão Enterprise;
Propriedades em comum:
| Propriedade | Descrição | Tipo | Exemplo |
|---|---|---|---|
| Altura | Define a altura do componente | Inteiro | 250 |
| Código | Informa o código gerado pelo Maker ao qual o componente/formulário foi associado. De forma geral, não interfere nas características do componente. | Inteiro | 5 |
| Container | Informa em qual container o componente irá ser inserido. | Indefinido | |
| Dica | Armazena uma dica para o componente, o qual se torna acessível no modo de inserção ou alteração. | Letras | "Digite o CPF do cliente" |
| Habilitado | Torna o componente possível ser editado ou manipulado. | Lógico | Sim |
| PosiçãoX e PosiçãoY | O "X" determina a posição do componente em relação à esquerda do formulário, e o "Y" em relação ao topo. | Inteiro | 100 |
| Tabulação | Indica a ordem de tabulação do componente em relação aos outros que compõem a aba do formulário na qual está posto. Essa ordem pode ser observada quando o usuário altera o estado do formulário/grade para o modo de inclusão ou edição e navega entre os componentes/campos usando a tecla Tab. | Inteiro | 2 |
| Tabular | Selecionando a opção Sim, quando o usuário estiver navegando entre os componentes, como foi descrito no item anterior, o componente receberá foco (observada a ordem de tabulação). | Lógico | Sim |
| Tamanho | Aplicado a todos - determina a largura do componente ou formulário. | Inteiro | 100 |
| Visível | Aplicada a todos os componentes, com exceção da Moldura e do objeto formulário - Selecionando a opção Sim, o componente aparece no formulário. | Lógico | Sim |
| Nome | Aplicada a todos os componentes e para o objeto formulário - apresenta o nome do componente. O Maker sugere um nome diferente dos nomes dos componentes existentes no formulário para evitar que mais de um componente possua o mesmo nome. | Letras | "Tabela de Consumidores" |
| Descrição | Aplicada a todos os componentes exceto para os componentes Árvore, Grade, Moldura, Imagem e para o objeto formulário - É a legenda que aparece sobre o componente para identificar (resumidamente) qual a sua função. Observação: Ao selecionar um determinado campo o Maker irá sugerir uma descrição obtida no dicionários de dados, caso o usuário deseje deixar o campo da descrição em branco basta apagá-lo e clicar fora do componente. | Letras | "Insira aqui a idade do consumidor" |
Propriedades específicas do componente Árvore:
| Propriedade | Descrição | Tipo | Exemplo |
|---|---|---|---|
| Borda | Define se o componente terá uma borda delimitando a sua área. | Lógico | Não |
| SQL | Esta propriedade informa a consulta SQL necessária para o perfeito funcionamento das propriedades de que tratam as propriedades Campo Chave e Campo Lista. | SQL | SELECT * FROM tabela_arvore |
| Campo Chave | Deve ser selecionado nesta propriedade o campo chave da entidade dentre os campos selecionados na consulta criada pela propriedade SQL. Esta propriedade será considerada para a criação dos diversos níveis hierárquicos. | Letras | campo_chave |
| Campo Ícone | Deve ser selecionado nesta propriedade um campo contendo um GUID que seja a identificação da imagem na Galeria de Imagens (FR_IMAGEM). Ao invés de o Webrun utilizar a imagem padrão para os nós da árvore e itens destes nós, serão utilizadas as imagens contidas em cada registro do campo GUID selecionado. | Letras | campo_icone |
| Campo Lista | Deve ser selecionado nesta propriedade o campo que descreva o campo chave da entidade dentre os campos selecionados na consulta criada pela propriedade SQL. Esta propriedade será considerada para a descrição (nome) dos níveis hierárquicos. | Letras | campo_lista |
| Campo Pai | Esta propriedade identifica o campo de auto-relacionamento que comporá a hierarquia dos registros. Caso se queira apenas mostrar uma lista simples (sem níveis), informe manualmente o valor NULL nesta propriedade. | Letras | campo_pai |
| Carga Postergada | Define se os subitens de um item superior só serão consultados no momento em que o usuário expandir (clicando no + de cada nó) o item superior. | Lógico | Não |
Eventos:
| Evento | Descrição | Parâmetro Automático |
|---|---|---|
| Antes de Contrair | O evento ocorre entre a execução de um clique no símbolo "-" (menos) que fica à esquerda da pasta (nó) e antes da contração efetiva da pasta. | - |
| Antes de Expandir | O evento ocorre entre a execução de um clique no símbolo "+" (mais) que fica à esquerda da pasta (nó) e antes da expansão efetiva da pasta. | - |
| Depois de Contrair | O evento ocorre após a execução de um clique no símbolo "-" (menos) que fica à esquerda da pasta (nó). | - |
| Depois de Expandir | O evento ocorre após a execução de um clique no símbolo "+" (mais) que fica à esquerda da pasta (nó). | - |
| Ao Duplo Clicar | O evento ocorre entre o momento em que o usuário efetua um duplo clique sobre a pasta ou sobre um item de uma pasta (nó); | - |