Gestão programada de áreas web

Os comandos deste tema são dedicados  a gestão programada de objetos de formulário de tipo área web.

As áreas web podem mostrar todo tipo de conteúdo web  mesmo dentro do ambiente 4D: as páginas HTML com conteúdos estáticos ou dinâmicos, arquivos, imagens, Javascript, Flash, PDF, etc. e inclusive documentos MS (em Windows quando MS Office estiver instalado). A  imagem abaixo mostra uma área web incluída em um formulário e mostra uma página HTML:

Além  dos comandos do tema web Area, várias ações e eventos de formulários dedicados permitem ao desenvolvedor controlar o funcionamento das áreas web. Podem ser utilizadas variáveis específicas para intercambiar informação entre a área e o ambiente 4D. Estas ferramentas podem ser utilizadas para desenvolver um navegador web básico em seus formulários.

A criação de um área web se realiza com a ajuda de uma variante do botão Area de plug-im/Sub-formulário da barra de objetos do editor de formulários de 4D (para maior informação, consulte o manual de Desenho).

Como os outros objetos dinâmicos do formulário, uma área web dispõe de um nome de objeto e de um nome de variável, que podem ser utilizados para manejá-la por programação. A variável padrão associada ao objeto área web é de tipo Texto. Específicamente, pode utilizar os comandos OBJECT SET VISIBLE e OBJECT MOVE com as áreas web.

Nota: a variável Texto associada a área web não contém uma referência portanto não pode ser passada como parâmetro a um método. Por exemplo, para uma área web chamada MinhaArea, não pode ser utilizado o seguinte código:

Código para MeuMétodo:

Para este tipo de programação, precisará utilizar ponteiros:

Código de MeuMetodo:

Para poder mostrá-las em Mac OS, as áreas web devem estar incluídas nas janelas criadas em "modo compositing." Este modo interno de gestão de janelas em Mac OS não é utilizada em todas as janelas de 4D.

Em 4D v11 SQL, as janelas criadas em "modo compositing" são:

• as janelas geradas pelos comandos  Open window e Open form window que tenham o tipo "Compositing Mode " (constante de valor 4096);
• em modo Desenho, as janelas mostram um formulário projeto.

Nota: certos objetos de antiga geração não são compatíveis com o "compositing mode" (por exemplo as áreas 4D Chart). Se forem mostradas em janelas em "compositing mode", estes objetos não funcionarão.

Além  das variáveis de objetos padrão (ver parágrafo anterior), duas variáveis específicas são associadas automaticamente a cada área web:

•  A variável "URL"
•  A variável "Progression".
  Por padrão, estas variáveis são chamadas respectivamente, areaName_url e areaName_progress. Pode modificar estes nomes se assim o desejar. Estas variáveis são acessíveis na Lista de propriedades:

A variável "URL" é de tipo string. Contém a URL carregada ou que está sendo carregada pela área web associada.
A associação entre a variável e a área web funciona em ambas as direções:

• Se o usuário atribui um novo URL à variável, esta URL é carregada automaticamente pela área web.
• Toda navegação realizada ao interior da área web atualizará automaticamente o conteúdo da variável.
  Esquematicamente, esta variável funciona como o área de endereço de um navegador web. Pode representá-la por uma área de texto situada sobre a área Web.

A variável URL produz os mesmos efeitos que o comando WA OPEN URL. Entretanto devem levar em consideração as seguintes diferenças:

• para acessar aos documentos, esta variável apenas aceita as URLs que estão de acordo com as RFC ("file://c:/Meu%20Doc") e não as rotas de acesso sistema ("c:\MeuDoc"). O comando WA OPEN URL aceita as duas notações.
• se a variável URL contiver uma string vazia, a área web não tenta carregar a URL. O comando WA OPEN URL gera um erro em este caso.
• se a variável URL não contiver um protocolo (http, mailto, file, etc.), a área web adiciona "http://", que não é o caso para o comando WA OPEN URL
  quando a área web não for mostrada no formulário (quando se localiza em outra página do formulário), a execução do comando WA OPEN URL não tiver efeito, enquanto que a atribuição de um valor à variável URL pode ser utilizada para atualizar a URL atual.

"Progresso" é uma variável de tipo Inteiro longo. Contém um valor entre 0 e 100, representa a porcentagem de carregamento completo da página mostrada na área web.

Esta variável é atualizada automaticamente por 4D. Não é possível modificá-la manualmente.

Os eventos formulário específicos estão destinados a gestão programada de áreas web, particularmente a ativação de links:

• On Begin URL Loading
• On URL Resource Loading
• On End URL Loading
• On URL Loading Error
• On URL Filtering
• On Open External Link
• On Window Opening Denied

Além disso, as áreas web são compatíveis com os eventos de formulário genéricos abaixo:

• On Load
• On Unload
• On Getting Focus
• On Losing Focus

Para maior informação sobre estes eventos, consulte a descrição do comando  Form event

Durante a execução do formulário, o usuário dispone das funções de interface padrão dos navegadores no área web, lo qual permite a interação com as outras áreas do formulário:

• comandos do menu Edição: quando o área web tiver o foco, os comandos do menu Edição permitem realizar ações como copiar, pegar, selecionar todo, etc., de acordo a a seleção.
• menu contextual: é possível associar um menu contextual padrão ao área web através a lista de propriedades. A visualização de este menu contextual pode controlarse utilizando o comando WA SET PREFERENCE).
• arrastar e soltar: o usuário pode arrastar e soltar texto, imagens e documentos dentro da área web ou entre uma área web e os objetos dos formulários 4D, em função das propriedades dos objetos 4D.

Em Windows, as áreas Web são compatíveis com  a visualização e a modificação dos documentos Microsoft Office (quando Microsoft Office estiver instalado na máquina). Em particular, os documentos Word, Excel e Powerpoint (extensões .doc, .xls e .ppt) podem ser manejados. O formato XML MS Office também é compatível.

Nota: MS Office 2007 não permite, por padrão, a visualização de documentos em um navegador Web; sempre estão abertos em uma nova janela. Pode modificar este funcionamento utilizando as instruções que se encontram nesta direção: http://support.microsoft.com/kb/162059/em-us

Em Windows, as áreas Web podem ser usadas para mostrar as pastas locais ou externas através do protocolo ftp:// ou através das rotas de acesso de rede (\\meuservidor\meuvolume).

Em Windows, não é recomendável acessar através de uma área web ao servidor web da aplicação 4D, que contém essa área, porque essa configuração pode provocar um conflito que paralize a aplicação. Logicamente, um 4D remoto pode acessar ao servidor web do 4D Server, mas não a seu próprio servidor web.

Os URLs administrados por programação em áreas web em Mac OS devem começar pelo protocolo. Por exemplo, deve passar a string "http://www.meusite.com" e não apenas "www.meusite.com".