• Revista PROGRAMAR: Já está disponível a edição #53 da revista programar. Faz já o download aqui!

silva.samuel

[Java/JSP]Como usar o JavaHelp

2 mensagens neste tópico

O javahelp é uma biblioteca do java, que está na versão 2.0, que serve para

apresentar ajuda ao utilizador, para uma aplicação.

O JavaHelp consiste num sistema de ficheiros XML e HTML para apresentar a ajuda

ao utilizador. A criação de uma ajuda usando o JavaHelp baseia-se na classe

HelpSet. A classe HelpSet refere-se ao conjunto de toda a ajuda compilada, que

poderá ser apresentada.

Ao criar a ajuda com o HelpSet seguimos três fases:

1- Criar um conjunto de ficheiros HTML, que contém a ajuda,

2- Criar ficheiros XML que irão controlar o acesso aos ficheiros HTML,

3- Criar outro ficheiro XML que define um HelpSet.

Para o ponto 1 podem-se usar ficheiros HTML criados por um qualquer editor de

HTML, desde que seja HTML 3.2, isto significa que não se podem usar javascripts.

No entanto, podem-se criar componentes Java e adicioná-los no ficheiro HTML

usando a tag HTML

<OBJECT>

.

Para o ponto 2 definem-se as relações entre os ficheiros XML e HTML e

descrevem-se vistas de ajuda.

Para se definir relações entre ficheiros XML e HTML utiliza-se um ficheiro que

normalmente tem a extensão ".jhm", sendo possivel também definir outra extensão.

A tag de raiz deverá ser sempre

<map>

que inclui várias tags

<mapID>

, com os

atributos target e url.

Estes ficheiros chamam-se de ficheiros Map.

Também é possível descrever várias vistas de utilização da ajuda, tais como:

a) Conteúdo

b) Índices

c) Procura

c) Glossário

d) Favoritos

O ficheiro de conteúdo tem como raiz a tag

<toc>

e inclui várias tags

<tocitem>

que se podem colocar em árvore, com os atributos text e target. A propriedade do

atributo target deve estar no ficheiro Map.

O ficheiros de índices é semelhante, apenas se substitui toc por index, na

definição do ficheiro.

Sobre os outros tipos de ficheiros ainda não os sei utilizar.

Para o ponto 3 cria-se um ficheiro que define quais os ficheiros map a utilizar,

quais as vistas a utilizar, e outras especificações que se podem fazer.

Este ficheiro normalmente tem como extensão ".hs" de HelpSet, sendo possível

também definir outra extensão.

A tag de raiz deste ficheiro é

<helpset>

. Este ficheiro contém o título

<title>

,

a definição do ficheiro Map

<maps>

com

<homeID>

e

<mapref>

, e várias vistas.

Agora, depois de todos os ficheiros criados apenas falta criar o código java

para utilizar os ficheiros de ajuda. Apresento de seguida uma opção:

       String path = "file:" +
               "helpset.hs";
       try{
           URL url = new URL(path);
           HelpSet set = new HelpSet(null,url);
           JHelp help= new JHelp(set);
           JFrame f = new JFrame();
           f.setContentPane(help);
           f.setTitle("Ajuda");
           f.setSize(400,450);
           f.setVisible(true);
       }
       catch(Exception e){this.addLog("HelpSet \"" + path + "\" not found");}

A exposição não foi completa, para mais informações consultem a documentação que

vem com o javahelp em "http://java.sun.com/products/javahelp".

0

Partilhar esta mensagem


Link para a mensagem
Partilhar noutros sites

Crie uma conta ou ligue-se para comentar

Só membros podem comentar

Criar nova conta

Registe para ter uma conta na nossa comunidade. É fácil!


Registar nova conta

Entra

Já tem conta? Inicie sessão aqui.


Entrar Agora