Software Público Brasileiro

/**
 * Title: Ajuda
 *
 * i3GEO.ajuda
 *
 * Manipulação das mensagens de ajuda.
 *
 * Permite definir a mensagem padrão da janela de mensagens. Abrir a
 * janela e definir seu conteúdo. Controla também o letreiro
 * móvel que mostra mensagens especiais definidas em cada layer
 * adicionado ao mapa.
 *
 * Exemplos:
 *
 * Se vc não quiser que a janela de ajuda seja aberta, inclua em seu HTML
 * ou javascript
 *
 * i3GEO.ajuda.ATIVAJANELA = false;
 *
 * Para enviar uma mensagem para a janela (quando estiver aberta), utilize
 *
 * i3GEO.ajuda.mostraJanela("texto");
 *
 * Para enviar uma mensagem temporária utilize:
 *
 *
 * Arquivo:
 *
 * i3geo/classesjs/classe_ajuda.js
 *
 * Licença:
 *
 * GPL2
 *
 * i3Geo Interface Integrada de Ferramentas de Geoprocessamento para Internet
 *
 * Direitos Autorais Reservados (c) 2006 Ministério do Meio Ambiente
 * Brasil Desenvolvedor: Edmar Moretti edmar.moretti@gmail.com
 *
 * Este programa é software livre; você pode redistribuí-lo
 * e/ou modificá-lo sob os termos da Licença Pública Geral
 * GNU conforme publicada pela Free Software Foundation;
 *
 * Este programa é distribuído na expectativa de que seja
 * útil, porém, SEM NENHUMA GARANTIA; nem mesmo a garantia
 * implícita de COMERCIABILIDADE OU ADEQUACÃO A UMA FINALIDADE
 * ESPECÍFICA. Consulte a Licença Pública Geral do GNU para
 * mais detalhes. Você deve ter recebido uma cópia da
 * Licença Pública Geral do GNU junto com este programa; se
 * não, escreva para a Free Software Foundation, Inc., no endereço
 * 59 Temple Street, Suite 330, Boston, MA 02111-1307 USA.
 */
if (typeof (i3GEO) === 'undefined') {
	var i3GEO = {};
}
i3GEO.ajuda = {
	/**
	 * Propriedade: ATIVAJANELA
	 *
	 * Define se a janela de mensagens pode ou não ser aberta.
	 *
	 * Tipo {Boolean} - true
	 */
	ATIVAJANELA : true,
	/**
	 * Propriedade: DIVAJUDA
	 *
	 * Nome do elemento HTML, do tipo DIV, que irá conter os textos de
	 * ajuda.
	 *
	 * Se esse DIV for encontrado no mapa, os textos serão mostrados em
	 * seu interior.
	 *
	 * Tipo {String} - i3geo_ajuda
	 */
	DIVAJUDA : "i3geo_ajuda",
	/**
	 * Propriedade: DIVLETREIRO
	 *
	 * Id do elemento HTML onde será incluído o banner (letreiro)
	 * de mensagens.
	 *
	 * Esse tipo de mensagem é obtida do METADATA "MENSAGEM" que pode ser
	 * incluído em um layer.
	 *
	 * Tipo {String} - i3geo_letreir
	 */
	DIVLETREIRO : "i3geo_letreiro",
	/**
	 * Propriedade: MENSAGEMPADRAO
	 *
	 * Mensagem que será incluída ao iniciar a janela de mensagens
	 * ou quando não houver mensagem definida para o elemento sobre o
	 * qual o mouse estaciona.
	 *
	 * Tipo {String} - $trad("p1")
	 */
	MENSAGEMPADRAO : $trad("p1"),
	/**
	 * Propriedade: TRANSICAOSUAVE
	 *
	 * Altera a transparência quando o mouse sobrepõe a janela e
	 * quando sai
	 *
	 * Tipo {boolean} - true
	 */
	TRANSICAOSUAVE : true,
	/**
	 * Propriedade: OPACIDADE
	 *
	 * Valor da opacidade mínima utilizada quando TRANSICAOSUAVE for
	 * igual a true.
	 *
	 * Varia de 0 a 100
	 *
	 * Tipo {numeric} - 20
	 */
	OPACIDADE : 20,
	/**
	 * Function: abreDoc
	 *
	 * Abre a documentacao do i3geo em uma nova janela do navegador
	 *
	 * Parametro:
	 *
	 * url {string} - url que será adicionada a i3GEO.configura.locaplic
	 */
	abreDoc : function(url) {
		if (!url) {
			url = "/documentacao/index.html";
		}
		window.open(i3GEO.configura.locaplic
				+ url);
	},
	/**
	 * Function: abreJanela
	 *
	 * Abre a janela flutuante para mostrar as mensagens de ajuda.
	 *
	 * Essa função é executada na
	 * inicialização do i3GEO
	 */
	abreJanela : function() {
		try {
			var nx, ny, corpo, texto, janela, temp, largura = 262, YU = YAHOO.util, pos = [
					20, i3GEO.parametros.h / 2
			];
			if (this.ATIVAJANELA === false) {
				return;
			}
			temp = $i("contemFerramentas");
			if (temp) {
				largura = parseInt(
					temp.style.width,
					10) - 5;
			}
			if (!$i("janelaMenTexto")) {
				corpo = $i(i3GEO.Interface.IDCORPO);
				if (corpo) {
					pos = YU.Dom.getXY(corpo);
				} else {
					corpo = $i(i3GEO.Interface.IDMAPA);
					if (corpo) {
						pos = YU.Dom.getXY(corpo);
					}
				}
				nx = pos[0]
						- largura
						- 3;
				ny = i3GEO.parametros.h - 78;
				texto = '<div id="janelaMenTexto" style="text-align:left;font-size:10px;color:rgb(80,80,80)">'
						+ i3GEO.ajuda.MENSAGEMPADRAO
						+ '</div>';
				if (nx < 0) {
					nx = 10;
					ny = ny - 50;
				}
				janela = i3GEO.janela.cria(
					largura - 3,
					70,
					"",
					nx,
					ny,
					"&nbsp;",
					"i3geo_janelaMensagens",
					false,
					"hd",
					"",
					"",
					true);
				janela[2].innerHTML = texto;
				YU.Event.addListener(
					janela[0].close,
					"click",
					i3GEO.ajuda.fechaJanela);
				this.ativaCookie();

			}
		} catch (e) {}
	},
	/**
	 * Ativa o cookie g_janelaMen e inclui o valor "sim".
	 *
	 * Toda a vez que a janela &eacute; aberta, o cookie &eacute; ativado.
	 *
	 * Ativando-se o cookie, a janela de mensagens ser&aacute; aberta
	 * automaticamente a pr&oacute;xima vez que o i3geo for iniciado
	 */
	ativaCookie : function() {
		var i = i3GEO.util.insereCookie;
		i(
			"g_janelaMen",
			"sim");
		i(
			"botoesAjuda",
			"sim");
	},
	/**
	 * Busca mensagens no metadata "MENSAGEM" existentes nos layers do mapa.
	 *
	 * Se existirem mensagens, as mesmas s&atilde;o inclu&iacute;das no
	 * letreiro.
	 *
	 * O letreiro deve ser um elemento do tipo INPUT (text).
	 *
	 * Parametro:
	 *
	 * mensagem {String} - (opcional) texto que ser&aacute; mostrado no
	 * letreiro. Se n&atilde;o for informado ser&aacute; utilizado a
	 * vari&aacute;vel i3GEO.parametros.mensagens
	 */
	ativaLetreiro : function(mensagem) {
		var l;
		if ($i(i3GEO.ajuda.DIVLETREIRO)) {
			if (arguments.length === 0) {
				mensagem = i3GEO.parametros.mensagens;
			}
			if (i3GEO.eventos.NAVEGAMAPA.toString().search(
				"i3GEO.ajuda.ativaLetreiro()") < 0) {
				i3GEO.eventos.NAVEGAMAPA.push("i3GEO.ajuda.ativaLetreiro()");
			}
			try {
				clearTimeout(i3GEO.ajuda.tempoLetreiro);
			} catch (e) {
				i3GEO.ajuda.tempoLetreiro = "";
			}
			l = $i(i3GEO.ajuda.DIVLETREIRO);
			if (l.style.display === "none") {
				return;
			}
			l.style.cursor = "pointer";
			if (mensagem === "") {
				l.value = "";
				return;
			}
			if (l.size === 1) {
				l.size = i3GEO.parametros.w / 8;
			}
			BMessage = mensagem
					+ " ---Clique para parar--- ";
			l.onclick = function() {
				l.style.display = "none";
			};
			if (BMessage !== " ---Clique para parar--- ") {
				BQuantas = 0;
				BSize = l.size;
				BPos = BSize;
				BSpeed = 1;
				BSpaces = "";
				i3GEO.ajuda.mostraLetreiro();
			}
			i3GEO.ajuda.mostraLetreiro(mensagem);
		}
	},
	/**
	 * Desativa o cookie g_janelaMen.
	 *
	 * Toda a vez que a janela &eacute; fechada, o cookie &eacute; desativado.
	 *
	 * Desativando-se o cookie, a janela de mensagens n&atilde;o ser&aacute;
	 * aberta automaticamente a pr&oacute;xima vez que o i3geo for iniciado
	 */
	desativaCookie : function() {
		i3GEO.util.insereCookie(
			"g_janelaMen",
			"nao");
	},
	/**
	 * Function: fechaJanela.
	 *
	 * Fecha a janela de ajuda.
	 */
	fechaJanela : function() {
		i3GEO.ajuda.desativaCookie();
		i3GEO.util.removeChild(
			"i3geo_janelaMensagens_c",
			document.body);
	},
	/**
	 * Function: mostraJanela
	 *
	 * Mostra um texto dentro da janela de mensagens padr&atilde;o.
	 *
	 * Parametro:
	 *
	 * texto {String} - texto a ser mostrado
	 */
	mostraJanela : function(texto) {
		var j = $i(this.DIVAJUDA), k = $i("janelaMenTexto"), jm = $i("i3geo_janelaMensagens"), Dom = YAHOO.util.Dom, h = parseInt(
			Dom.getStyle(
				jm,
				"height"),
			10);
		if (j) {
			j.innerHTML = texto === "" ? "-" : texto;
		} else {
			if (h) {
				Dom.setY(
					"i3geo_janelaMensagens",
					Dom.getY(jm)
							+ h);
			}
			if (k) {
				k.innerHTML = texto;
			}
			if (this.TRANSICAOSUAVE) {
				texto !== "" ? Dom.setStyle(
					jm,
					"opacity",
					"1") : Dom.setStyle(
					jm,
					"opacity",
					(this.OPACIDADE / 100));
			}
			h = parseInt(
				Dom.getStyle(
					jm,
					"height"),
				10);
			if (h) {
				Dom.setY(
					jm,
					Dom.getY(jm)
							- h);
			}
		}
	},
	/**
	 * Function: mostraLetreiro
	 *
	 * Preenche o elemento INPUT com a mensagem de texto e faz a
	 * movimenta&ccedil;&atilde;o das letras.
	 *
	 * O aparecimento das letras &eacute; controlado por um temporizador e as
	 * mensagens s&atilde;o mostradas apenas duas vezes, desde o in&iacute;cio
	 * do redesenho do mapa.
	 */
	mostraLetreiro : function() {
		for (var count = 0; count < BPos; count += 1) {
			BSpaces += " ";
		}
		if (BPos < 1) {
			$i(i3GEO.ajuda.DIVLETREIRO).value = BMessage.substring(
				Math.abs(BPos),
				BMessage.length);
			if (BPos
					+ BMessage.length < 1) {
				BPos = BSize;
				BQuantas = BQuantas + 1;
			}
		} else {
			$i(i3GEO.ajuda.DIVLETREIRO).value = BSpaces
					+ BMessage;
		}
		BPos -= BSpeed;
		if (BQuantas < 2) {
			i3GEO.ajuda.tempoLetreiro = setTimeout(
				function() {
					i3GEO.ajuda.mostraLetreiro();
				},
				140);
		}
	},
	/**
	 * Function: redesSociais
	 *
	 * Abre uma janela com informa&ccedil;&otilde;es sobre a presen&ccedil;a do
	 * i3Geo em redes sociais
	 */
	redesSociais : function() {
		i3GEO.janela.cria(
			"400px",
			"400px",
			i3GEO.configura.locaplic
					+ "/ferramentas/redessociais/index.php",
			"",
			"",
			$trad("u5c"),
			YAHOO.util.Dom.generateId(
				null,
				"redes"));
	}
};