Área Web

---

Acessar métodos 4D

Você pode chamar métodos 4D e funções de classe a partir do código JavaScript executado em uma área Web e obter valores em troca. Para consegue chamar métodos 4D de uma área Web, você deve ativar o parâmetro de acessibilidade 4D ("todos").

Esta propriedade só está disponível se a área Web usar o mecanismo de renderização Web incorporado.

Quando essa propriedade estiver ativada, um objeto JavaScript especial chamado $4d é instanciado na área Web, que você pode usar para gerenciar chamadas para métodos projeto e funciones 4D.

Gramática JSON

Nome	Tipo de dados	Valores possíveis
methodsAccessibility	string	"none" (padrão), "all"

Objectos suportados

Área web

---

Progressão

Nome de uma variável do tipo Longint. Essa variável receberá um valor entre 0 e 100, representando a porcentagem de conclusão do carregamento da página na área Web. Atualizado automaticamente por 4D, não pode ser modificado manualmente.

As of 4D 19 R5, this variable is only updated on Windows if the Web area uses the embedded Web rendering engine.

Gramática JSON

Nome	Tipo de dados	Valores possíveis
progressSource	string	Nome de uma variável Longint

Objectos suportados

Área web

---

URL

Uma variável do tipo String que designa o URL carregado ou que está sendo carregado 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 atribuir um novo URL à variável, esse URL será carregado automaticamente pela área Web.
• Qualquer navegação feita na área Web atualizará automaticamente o conteúdo da variável.

Esquematicamente, essa variável funciona como a área de endereço de um navegador Web. Pode representá-lo através de uma área de texto por cima da área Web.

Variável URL e comando WA OPEN URL

The URL variable produces the same effects as the WA OPEN URL command. No entanto, há que assinalar as seguintes diferenças:

• Para acesso a documentos, essa variável aceita apenas URLs em conformidade com a RFC ("file://c:/My%20Doc") e não nomes de caminho do sistema ("c:\MyDoc"). The WA OPEN URL command accepts both notations.
• Se a variável URL contiver uma cadeia de caracteres vazia, a área Web não tentará carregar o URL. The WA OPEN URL command generates an error in this case.
• If the URL variable does not contain a protocol (http, mailto, file, etc.), the Web area adds "http://", which is not the case for the WA OPEN URL command.
• When the Web area is not displayed in the form (when it is located on another page of the form), executing the WA OPEN URL command has no effect, whereas assigning a value to the URL variable can be used to update the current URL.

Gramática JSON

Nome	Tipo de dados	Valores possíveis
urlSource	string	Um URL.

Objectos suportados

Área web

Comandos

WA GET PREFERENCE - WA SET PREFERENCE

---

Utilizar o motor de renderização Web integrado

Essa opção permite escolher entre dois mecanismos de renderização para a área Web, dependendo das especificidades de sua aplicação:

• desmarcada - valor JSON: system (padrão): neste caso, 4D usa o mecanismo "melhor" correspondente ao sistema. Isso significa que você se beneficia automaticamente dos mais recentes avanços na renderização da Web, por HTML5 ou JavaScript. No entanto, você poderá notar algumas diferenças de renderização entre as plataformas. No Windows, 4D usa Microsoft Edge WebView2. No macOS, 4D usa a versão atual do WebKit (Safari).

No Windows, se o Microsoft Edge WebView2 não estiver instalado, o 4D usa o mecanismo incorporado como mecanismo de renderização do sistema. Para saber se ele está instalado no seu sistema, procure "Microsoft Edge WebView2 Runtime" no painel de aplicações.

• marcado - valor JSON: anidado: en este caso, 4D utiliza Chromium Embedded Framework (CEF). Usar o mecanismo da Web incorporado significa que a renderização da área da Web e seu funcionamento em seu aplicativo são idênticos, independentemente da plataforma usada para executar 4D (pequenas variações de pixels ou diferenças relacionadas à implementação da rede podem, no entanto, ser observadas). When this option is chosen, you no longer benefit from automatic updates of the Web engine performed by the operating system; however, new versions of the engines are regularly provided through 4D.

The Blink engine has the following limitations:

• WA SET PAGE CONTENT: using this command requires that at least one page is already loaded in the area (through a call to WA OPEN URL or an assignment to the URL variable associated to the area).
• When URL drops are enabled by the WA enable URL drop selector of the WA SET PREFERENCE command, the first drop must be preceded by at least one call to WA OPEN URL or one assignment to the URL variable associated to the area.

nota

Você pode personalizar os parâmetros da área CEF criando um arquivo de configuração local 4DCEFParameters.json.

Gramática JSON

Nome	Tipo de dados	Valores possíveis
webEngine	string	"embedded", "system"

Objectos suportados

Área web

Comandos

WA GET PREFERENCE - WA SET PREFERENCE