4.5 Páginas
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Adiciona uma nova página ao seu documento.
Uma página não deve ser confundida como uma "quebra de página". Enquanto uma "quebra de página" (explicada no comando FI em 4.7 Campos) provoca uma geração de nova página física, o conteúdo de uma página, definida por este comando, poderá ser acessado em Helps de seus programas, ou em links de outras páginas de seu documento. Sendo assim, uma página definida por este comando poderá utilizar uma ou várias páginas físicas nos arquivos de saída.
Atributo "N" : Page Name
É o nome da página que poderá ser referenciado em Links, por exemplo.
Atributo "OWN" : Page Owner Name
É o nome da página à qual esta pertence.
Isso permite implementar encadeamento de páginas de modo a se montar a árvore do seu documento.
Caso seja fornecido OWN={ } (em branco) não será gerado erro (como ocorre se você fizer isso no Page Name). Neste caso, tudo se passa como se você não tivesse fornecido esse argumento, ficando a página sem owner, ou seja, será uma página "raiz".
Atributo "CP" : Caption
É o texto que define o Título da página.
Atributo "CS" : Caption Style
Define o estilo que o Caption será exibido caso se utilize o comando FI com Field Kind = PC (explicado em 4.7 Campos).
Pode possuir os valores:
0 : Nada será adicionado.
1 : O Caption será precedido por sua numeração ordinal pontuada (ex.: 1.3.2).
Neste último caso serão consideradas apenas as páginas que tiverem CS = 1.
Por exemplo, imagine um documento com as páginas:
Página1
Página2
Página21
Página21
Página3
Página4
Página41
Página42
Supondo que apenas as páginas: Página2, Página21, Página22, Página4, Página41 e Página42 tenham CS = 1, caso sejam aplicados os Caption Style (via comando FI) o resultado será:
Página1
1 Página2
1.1 Página21
1.2 Página21
Página3
2 Página4
2.1 Página41
2.2 Página42
Atributo "HC" : Help Context
Este atributo é aplicado quando você desenvolve um programa aplicativo e deseja implementar um Help conextual nele.
Caso este atributo seja setado com valor diferente de zero e sejam gerados os arquivos de saída em .HTML Multi Page (explicado em 5.3 Jobs) será gerado um arquivo com nome [Nome do Arquivo de Entrada]__HC_N.html (onde N será o valor atribuído aqui). Esse arquivo poderá ser acessado pelo Help de seu programa no contexto correspondente e essa página será exibida.
Consulte 6.4 Exemplos para ver onde se encontram exemplos para você implementar isso em seus programas.
Atributo "LOG" : Log access
É o valor boleano que indica se esta página será registrada ou não quando for acessada via Web.
Este atributo somente é aplicado caso você especifique a saída .ASP em HTML Multi Page em Form 5.3 Jobs.
Caso você sete este atributo e gere a saída acima, quando a página for acessada será gerada uma linha a mais no arquivo:
C:\_SitesPageLogs_2007_09_25.txt
Onde:
C: será o drive onde sua página estiver hospedada.
2007_09_25 será a data do acesso.
Nesse arquivo, a linha adicionada será algo como, por exemplo:
| 2007/09/25 03:16:54,687 | 127.0.0.1 | MyManual | MyPageName | MyPageCaption |
Note que ficará registrada a data e hora do acesso, o IP Address de onde veio o acesso, o nome do seu manual (ou site), e o Name e Caption da página acessada.
Isso é útil para você observar (se desejar) os acessos às suas páginas (e gerar estatísticas também).
Importante
Quando este atributo é setado e são geradas as saídas .ASP em HTML Multi Page, em cada página é inserido um código JavaScript que abre (ou cria) o arquivo de Logs de páginas (acima) para a data atual e insere a linha que registra o acesso. Para isso "funcionar" suas páginas tem que ser acessadas via IIS (Internet Information Services) ou outro Web Server qualquer (desde que aceite JavaScript e o objeto Scripting.FileSystemObject) e deverá setar privilégios adequados para que o programa possa acessar arquivos, caso contrário os Logs das páginas não serão gravados, podendo, inclusive ocorrer erros de acesso ou permissões.
Se você não desejar registrar logs de páginas, gere apenas arquivos .HTML, pois assim poderão ser acessadas localmente (ou via IIS) e seus acessos ficam mais rápidos (já que os registros dos Logs não serão efetuados).
Caso você utilize as saídas DMHelp para gerar Helps para seus programas, somente poderá utilizar este atributo se o Help do seu programa acessar a Internet (já que as mesmas deverão estar adequadamente hospedadas). Caso você vá enviar os arquivos de helps gerados juntamente com seu programa, utilize apenas saídas .HTML.
Menu de Páginas
Caso sejam gerados os arquivos de saída em .HTML Multi Page (explicado em 5.3 Jobs) será gerado um arquivo com nome [Nome do Arquivo de Entrada].html que será a página principal do seu documento.
Ao acessar este arquivo serão exibidos dois frames onde o frame da esquerda exibirá o Menu de Páginas e o frame da direita exibirá as páginas quando forem clickadas.
Os atributos a seguir se aplicam ao Menu de Páginas descrito aqui, que fica exibido no frame da esquerda.
Atributo "MCP" : Menu Caption
É o texto que define o que será exibido no Menu de Páginas.
Se não for preenchido será exibido o Caption.
Atributo "MCS" : Menu Caption Style
Este atributo se comporta de maneira idêntica ao Caption Style só que aqui especifica como se aplica no Menu de Páginas.
Atributo "MHLP" : Menu Text Help
É o texto que define o que será exibido ao se passar o mouse pelo ícone do da página (no Menu de Páginas).
Se não for preenchido será exibido o Caption.
Atributo "MISF" : Menu Is Only Folder ?
Caso seja setado o conteúdo desta página não será exibido e somente o ícone de um Folder que poderá ser aberto ou fechado sendo exibidas suas sub-páginas (ou seja, páginas cujo Page Owner Name tenha o nome desta página).
Atributo "MVIS" : Menu Visible ?
É o valor boleano que indica se esta página será exibida (ou não) no Menu de Páginas.
Atributo "MEXP" : Menu Expanded ?
É o valor boleano que indica, caso possua sub-páginas, se a mesma será inicialmente exibida expandida ou não.
Atributo "MSPB" : Menu Spaces Before
É o valor inteiro que indica o número de espaços que serão exibidos no Menu de Páginas, ANTES do mesmo.
Atributo "MSPA" : Menu Spaces After
É o valor inteiro que indica o número de espaços que serão exibidos no Menu de Páginas, DEPOIS do mesmo.
Exemplo