Árvore de camadas

Monta a árvore com os temas existentes no mapa atual. A árvore contém as opções de ligar e desligar temas, alteração na ordem de desenho, links para acesso a funcionalidades, etc.

i3GEO.arvoreDeCamadas permite controlar quais as opções que serão mostradas na árvore e seu comportamento em diferentes situa&ccdil;õs.

Namespace

i3GEO.arvoreDeCamadas

Exemplo

Para alterar as opções da árvore, modifique as propriedades colocando um código como o seguinte no javascript utilizado na interface de mapa que estiver sendo utilizada

i3GEO.arvoreDeCamadas.OPCOESTEMAS = false;

Veja

http://localhost/i3geo/classesjs/classe_arvoredecamadas.js

Summary

Árvore de camadas	Monta a árvore com os temas existentes no mapa atual.
Constants
ARVORE	Objeto com a árvore criada com YAHOO.widget.TreeView Pode ser usado para receber métodos da API do YAHOO
IDHTML	Armazena o ID do elemento DOM onde a árvore foi inserida.
CAMADASINICIAIS	O mesmo que CAMADAS mas guarda de forma permanente as camadas que iniciaram o mapa
Variaveis
CAMADAS	Objeto com a lista de camadas existentes no mapa.
Propriedades
FINALIZA	Função ou nome de uma função que será executada após a árvore ter sido montada A funço permite ajustar a árvore conforme o programador desejar.
ATIVATEMA	Nome da função que será incluída no evento onclick do elemento checkbox adicionado no início do nome de um camada
TEMPLATELEGENDA	Nome do template HTML que sera usado para compor a legenda de cada tema.
BARRAPROGRESSO	Mostra uma barra na parte superior do mapa que indica o progresso do desenho das camadas do mapa
MOSTRALISTAKML	Mostra na árvore a lista de endereços de arquivos KML cadastrados no sistema de administração.
FILTRO	Filtro que será aplicado para restringir os tipos de camadas mostradas na árvore
VERIFICAABRANGENCIATEMAS	Verifica ou não se um tema da árvore está dentro da abrangência do mapa atual, marcando esses temas na árvore
EXPANDESOLEGENDA	Ao expandir um tema mostra apenas a legenda, sem as outras opções
PERMITEEXPANDIRTEMAS	Permite que as opções abaixo dos nós referentes a cada tema sejam mostradas
ARRASTARORDEM	Ativa a opção de arrastar um tema para alterar a ordem de desenho das camadas
REFRESH	Mostra ou não a opção que permite atualizar a ´rvore
ARRASTARLIXEIRA	Ativa a opção de arrastar um tema para a lixeria quando se quer removê-lo do mapa.
ALTERAOPACIDADE	Mostra ou não a opção que permite alterar a transparência das camadas existentes no mapa
ANIMAMAPA	Mostra ou não a opção que permite gerar uma animação do mapa, ligando e desligando camadas
LIGARDESLIGARTODOS	Mostra os ícones de desligar/ligar todos os temas.
FILTRAR	Mostra o ícone para filtrar as camadas.
ABRELEGENDA	Mostra o ícone para abrir a legenda do mapa.
EXPANDIDA	Indica se a árvore será montada de forma expandida ou não.
LEGENDAEXPANDIDA	Indica se a legenda da árvore será montada de forma expandida ou não.
OPCOESICONES	Inclui ou não os ícones de opções em cada tema (farol, zoom para o tema, etc)
OPCOESTEMAS	Inclui ou não o nó com as opções de manipulação de cada tema.
OPCOESLEGENDA	Inclui ou não o nó para mostrar a legenda do tema.
OPCOESARVORE	Inclui ou não as opções de ícones mostradas na raiz da ávore
AGUARDALEGENDA	Ativa a opção de aguarde para mostrar a legenda de um tema quando o usuário estaciona o mouse sobre o nome de um tema.
ICONETEMA	Mostra ou não o ícone do tema caso exista.
FUNCOES	Indicação de quais funções serão incluídas em cada tema mostrado na árvore quando o usuário aciona o item “opções”
Functions
cria	Cria a árvore com as opções de manipulação das camadas existentes no mapa
inicia	Essa função cria e inicializa a árvore de camadas utilizando o objeto default que contém os parâmetros de cada camada.
atualiza	Atualiza a árvore de camadas.
ligaDesligaTemas	Marca ou desmarca os checkbox da árvore de uma lista de temas
atualizaLegenda	Atualiza a legenda de um tema.
aplicaTemas	Refaz o mapa ligando e desligando os temas conforme consta na árvore de camadas ou ligando/desligando todos
listaLigadosDesligados	Lista os temas que estão ligados e os que estão desligados tendo como fonte de busca os checkbox existentes na árvore.
capturaCheckBox	Retorna o objeto input (check box) que corresponde a uma determinada camada na árvore.
pegaTema	Procura um tema no objeto CAMADAS.
alteraPropCamadas	Altera o valor de uma propriedade de um tema do objeto i3GEO.arvoreDeCamadas.CAMADAS
i3GEO.arvoreDeCamadas.dialogo	Abre as telas de diálogo das opções de manipulação da árvore
Functions
filtro	Abre a janela de diálogo para o usuário escolher ou alterar o filtro aplicado a árvore
excluir	Abre a janela de diálogo para o usuário escolher os temas que serão excluídos da árvore

Constants

ARVORE

Objeto com a árvore criada com YAHOO.widget.TreeView Pode ser usado para receber métodos da API do YAHOO

Tipo

{YAHOO.widget.TreeView}

IDHTML

Armazena o ID do elemento DOM onde a árvore foi inserida.

Tipo

{string}

Default

”listaTemas”

CAMADASINICIAIS

O mesmo que CAMADAS mas guarda de forma permanente as camadas que iniciaram o mapa

Tipo

{objeto}

Variaveis

CAMADAS

Objeto com a lista de camadas existentes no mapa. É definido na inicialização ou no redesenho do mapa.

Este objeto é construído nas operações em PHP de inicialização ou redesenho do mapa e lista todos os layers existentes no mapfile temporário em uso.

classesphp/classe_mapas.php

parametrosTemas

Tipo

{objeto}

Propriedades

FINALIZA

Função ou nome de uma função que será executada após a árvore ter sido montada A funço permite ajustar a árvore conforme o programador desejar. É executada apenas na criação da árvore

Tipo

{string}

Default

””

ATIVATEMA

Nome da função que será incluída no evento onclick do elemento checkbox adicionado no início do nome de um camada

Tipo

{string}

Default

””

TEMPLATELEGENDA

Nome do template HTML que sera usado para compor a legenda de cada tema. O HTML deve ser armazenado em i3geo/aplicmap. Templates de legenda seguem a sintaxe definida pelo software Mapserver

Tipo

{string}

Default

legenda5.htm

BARRAPROGRESSO

Mostra uma barra na parte superior do mapa que indica o progresso do desenho das camadas do mapa

Funciona apenas na interface Openlayers

Tipo

{boolean}

Default

true

MOSTRALISTAKML

Mostra na árvore a lista de endereços de arquivos KML cadastrados no sistema de administração. Quando presente no mapa, o usuário pode escolher um KML de uma lista pré-definida para ser adicionado

Tipo

{boolean}

Default

false

FILTRO

Filtro que será aplicado para restringir os tipos de camadas mostradas na árvore

Tipo

{ligados|desligados|selecionados|download|wms|raster|toponimia}

Default

””

VERIFICAABRANGENCIATEMAS

Verifica ou não se um tema da árvore está dentro da abrangência do mapa atual, marcando esses temas na árvore

A verificação só é feita se o tema possuir a extensão geográfica registrada (veja o sistema de administração)

Tipo

{boolean}

Default

false

EXPANDESOLEGENDA

Ao expandir um tema mostra apenas a legenda, sem as outras opções

Tipo

{boolean}

Default

false

PERMITEEXPANDIRTEMAS

Permite que as opções abaixo dos nós referentes a cada tema sejam mostradas

Tipo

{boolean}

Default

true

ARRASTARORDEM

Ativa a opção de arrastar um tema para alterar a ordem de desenho das camadas

Tipo

{boolean}

Default

true

REFRESH

Mostra ou não a opção que permite atualizar a ´rvore

Tipo

{boolean}

Default

true

ARRASTARLIXEIRA

Ativa a opção de arrastar um tema para a lixeria quando se quer removê-lo do mapa.

Tipo

{boolean}

Default

true

ALTERAOPACIDADE

Mostra ou não a opção que permite alterar a transparência das camadas existentes no mapa

Tipo

{boolean}

Default

true

ANIMAMAPA

Mostra ou não a opção que permite gerar uma animação do mapa, ligando e desligando camadas

Tipo

{boolean}

Default

true

LIGARDESLIGARTODOS

Mostra os ícones de desligar/ligar todos os temas.

Tipo

{boolean}

Default

true

FILTRAR

Mostra o ícone para filtrar as camadas.

Tipo

{boolean}

Default

true

ABRELEGENDA

Mostra o ícone para abrir a legenda do mapa.

Tipo

{boolean}

Default

true

EXPANDIDA

Indica se a árvore será montada de forma expandida ou não. Se true, os nós do primeiro nível serão abertos na inicialização da árvore.

Tipo

{boolean}

Default

false

LEGENDAEXPANDIDA

Indica se a legenda da árvore será montada de forma expandida ou não.

Tipo

{boolean}

Default

false

OPCOESICONES

Inclui ou não os ícones de opções em cada tema (farol, zoom para o tema, etc)

Tipo

{boolean}

Default

true

OPCOESTEMAS

Inclui ou não o nó com as opções de manipulação de cada tema.

Tipo

{boolean}

Default

true

OPCOESLEGENDA

Inclui ou não o nó para mostrar a legenda do tema.

Tipo

{boolean}

Default

true

OPCOESARVORE

Inclui ou não as opções de ícones mostradas na raiz da ávore

Tipo

{boolean}

Default

true

AGUARDALEGENDA

Ativa a opção de aguarde para mostrar a legenda de um tema quando o usuário estaciona o mouse sobre o nome de um tema.

Tipo

{boolean}

Default

false

ICONETEMA

Mostra ou não o ícone do tema caso exista.

O ícone é definido no METADATA ICONETEMA no mapfile correspondente ao tema (veja o sistema de administração

Tipo

{boolean}

Default

true

FUNCOES

Indicação de quais funções serão incluídas em cada tema mostrado na árvore quando o usuário aciona o item “opções”

Além de definir o item como false ou true, algumas funções apenas são mostradas em conformidade com o tipo de camada. No sistema de administração, pode-se também controlar algumas das funções, como por exemplo “sql”, “wms” e “temporizador”

Exemplo de como alterar um valor diretamente no javascript da interface do mapa

i3GEO.arvoreDeCamadas.FUNCOES.excluir = false;

i3GEO.arvoreDeCamadas.FUNCOES.farolescala = false;

farolescala	mostra o ícone que indica se a escala atual do mapa é compatível com a escala da camada
excluir	mostra o ícone que permite excluir uma camada da árvore
sobe	mostra o ícone para subir uma camada na ordem de camadas
desce	mostra o ícone para descer uma camada na ordem de camadas
fonte	mostra o ícone que abre a janela contendo a fonte da camada
zoomtema	mostra o ícone que permite fazer o zoom para o tema
compartilhar	mostra os botões de compartilhamento em redes sociais
opacidade	ajuste de opacidade da camada
mudanome	opção para mudar o nome da camada
procurar	abre a ferramenta de busca de dados
toponimia	abre a ferramenta de inclusão de laels nos elementos de uma camada
etiquetas	abre a ferramenta que permite definir que colunas da tabela de atributos serão mostradas no balão de identificação
filtrar	abre a ferramenta que permite aplicar um filtro nos dados da camada
tabela	abre a tabela de atributos
grafico	ferramenta de criação de gráficos associados à tabela de atributos
editorlegenda	ferramenta de edição das classes e simbologia da legenda
destacar	abre um box que segue o mouse mostrando a camada mesmo que esteja desligada
cortina	abre a ferramenta cortina
sql	abre a ferramenta que permite editar o SQL de camadas baseadas no POSTGIS (apenas para editores)
comentar	abre a ferramenta que permite incluir comentários sobre a camada no banco de administraÃ§Ã£o
temporizador	abre a ferramenta para controle do temporizador que força o desenho da camada
wms	mostra o endereço wms da camada
tme	abre a ferramenta que gera um KML em 3d
copia	faz uma cópia da camada e insere no mapa

Functions

cria

cria : function( onde,
temas,
g_sid,
g_locaplic,
funcaoTema )

Cria a árvore com as opções de manipulação das camadas existentes no mapa

Parametros

string	(opcional) ID do elemento DOM onde a árvore será inserida. Se for definido como “” o id será buscado da variável IDHTML.
objeto	(opcional) Objeto com as camadas e propriedades. Se não for definido ou for vazio, será utilizado i3GEO.arvoreDeCamadas.CAMADAS
string	(opcional) Código da seção PHP criada ao abrir o i3Geo
string	(opcional)
string	(opcional) Nome da função que será incluida no evento disparado quando o usuário clicar no checkbox de um tema

inicia

inicia : function( id )

Essa função cria e inicializa a árvore de camadas utilizando o objeto default que contém os parâmetros de cada camada. Faz o encadeamento das funções i3GEO.arvoreDeCamadas.cria e atualiza

i3GEO.arvoreDeCamadas.FINALIZA também é executado se existir

Parametros

string

id do elemento HTML onde a árvore será inserida

atualiza

atualiza : function( temas,
forca )

Atualiza a árvore de camadas.

Antes de executar a atualização, essa função verifica se é necessário fazê-lo. O objeto CAMADAS é comparado com o parametro “temas” para verificar se existem diferenças que justifiquem a atualização.

Parametros

{objeto}	Objeto com a lista de camadas e propriedades (veja CAMADAS). Se não existir, a árvore é redesenhada
{boolean}	força a atualização da árvore, sem verificar automaticamente se a atualização deve ou não ser feita

ligaDesligaTemas

ligaDesligaTemas : function( lista,
status )

Marca ou desmarca os checkbox da árvore de uma lista de temas

Parametros

{string}	lista, separada por vírgulas, dos códigos dos temas
{boolean}	marca ou desmarca

atualizaLegenda

atualizaLegenda : function( idtema )

Atualiza a legenda de um tema.

A legenda precisa ser atualizada emalgumas circunstâncias, como quando é feitoumzoom no mapa.

Parametro

{String}

ID (name) do tema

aplicaTemas

aplicaTemas : function( tipo )

Refaz o mapa ligando e desligando os temas conforme consta na árvore de camadas ou ligando/desligando todos

Parametro

{normal|ligartodos|desligartodos}

tipo de operação A opção ‘normal’ irá desligar/ligar o que estiver marcado

listaLigadosDesligados

listaLigadosDesligados : function( tipo )

Lista os temas que estão ligados e os que estão desligados tendo como fonte de busca os checkbox existentes na árvore.

Esse método é mais demorado pois varre a árvore toda. Porém, obtém o status verdadeiro do tema.

Parametro

{String}

mantem|marca|desmarca marca, desmarca ou mantém o checkbox após identificar seu status atual

Return

{Array}

array de arrays com os códigos dos temas [0]=ligados [1]=desligados [2]=todos na ordem encontrada

capturaCheckBox

capturaCheckBox : function( tema )

Retorna o objeto input (check box) que corresponde a uma determinada camada na árvore.

Parametro

{String}

código do tema ao qual o elemento se refere

Return

{Objeto DOM}

objeto do tipo checkbox

pegaTema

pegaTema : function( valor,
camadas,
parametro )

Procura um tema no objeto CAMADAS.

Parametro

{String} valor do parametro

{Objeto}	objeto com a lista de temas (escape com “” para usar o default)
{string}	parametro que sera procurado

Return

{objeto}

alteraPropCamadas

alteraPropCamadas : function( propriedade,
valor,
camada )

Altera o valor de uma propriedade de um tema do objeto i3GEO.arvoreDeCamadas.CAMADAS

Parameters

{string}	propriedade que será modificada
{string}	novo valor
{string}	código da camada

i3GEO.arvoreDeCamadas.dialogo

Abre as telas de diálogo das opções de manipulação da árvore

Summary

Functions
filtro	Abre a janela de diálogo para o usuário escolher ou alterar o filtro aplicado a árvore
excluir	Abre a janela de diálogo para o usuário escolher os temas que serão excluídos da árvore

Functions

filtro

filtro : function()

Abre a janela de diálogo para o usuário escolher ou alterar o filtro aplicado a árvore

excluir

excluir : function()

Abre a janela de diálogo para o usuário escolher os temas que serão excluídos da árvore