Webエリア
4Dメソッドコールを許可
Webエリアで実行される JavaScript コードから 4Dメソッドおよびクラス関数を呼び出して、戻り値を取得することができます。 4Dメソッドを Webエリアから呼び出せるようにするには、プロパティリストの "4Dメソッドコールを許可" にチェックをする必要があります。
この機能は Webエリアが 埋め込みWebレンダリングエンジンを使用 している場合に限り、使用可能です。
このプロパティがチェックされている場合、特別な JavaScript オブジェクト $4d が Webエリア内にインスタンス化され、これを使用して4Dプロジェクトメソッドおよび関数の呼び出しを管理 できるようになります。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| methodsAccessibility | string | "none" (デフォルト), "all" |
対象オブジェクト
進捗状況変数
倍長整数型変数の名前です。 この変数には 0 から 100 までの値が格納され、この数値は Webエリアに表示されるページのロードされたパーセンテージを表します。 手動で変更することはできません。
As of 4D 19 R5, this variable is only updated on Windows if the Web area uses the embedded Web rendering engine.
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| progressSource | string | 倍長整数型変数の名前 |
対象オブジェクト
URL
文字列型の変数で、Webエリアにロードされた URL またはロード中の URL が格納されます。 変数と Webエリア間の連携は双方向でおこなわれます。
- ユーザーが新しい URL を変数に割り当てると、その URL は自動で Webエリアにロードされます。
- Webエリアでブラウズされると、自動で変数の内容が更新されます。
このエリアは Webブラウザーのアドレスバーのように機能します。 Webエリアの上側にテキストエリアを置いて、内容を表示させることができます。
URL変数と WA OPEN URL コマンド
URL 変数はWA OPEN URL と同じ効果を生み出します。 しかしながら、以下の違いに注意してください。
- ドキュメントにアクセスする場合、この変数は RFC準拠 ("file://c:/My%20Doc") な URL のみを受け付け、システムパス名 ("c:\MyDoc") は受け付けません。
WA OPEN URLコマンドは両方の記法を受け入れます。 - URL変数が空の文字列の場合、Webエリアは URL をロードしません。
WA OPEN URLコマンドは、この場合にはエラーを生成します。 - URL変数がプロトコル (http, mailto, file など) を含まない場合、Webエリアは "http://" を付加しますが、
WA OPEN URLコマンドはこれを付加しません。 - Webエリアがフォーム上で表示されていない場合 (フォームの別ページに Webエリアがある場合等)、
WA OPEN URLコマンドを実行しても効果はありません。 一方、URL変数に値を代入すると、カレントURL が更新されます。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| urlSource | string | URL |
対象オブジェクト
コマンド
WA GET PREFERENCE - WA SET PREFERENCE
埋め込みWebレンダリングエンジンを使用
このオプションを使用して、Webエリアで使用する描画エンジンを 2つのうちから選択することができます:
- チェックなし -
JSON値: system(デフォルト): この場合、4Dはシステムの最適なエンジンを使用します。 この結果、HTML5 や JavaScript の最新 Web描画エンジンを自動的に利用できることになります。 しかし、プラットフォーム間で若干描画に違いがでることがあります。 Windows では、4Dは Microsoft Edge WebView2 を使用します。 macOS では、カレントバージョンの WebKit (Safari) です。 この結果、HTML5 や JavaScript の最新 Web描画エンジンを自動的に利用できることになります。 しかし、プラットフォーム間で若干描画に違いがでることがあります。 Windows では、4Dは Microsoft Edge WebView2 を使用します。 macOS では、カレントバージョンの WebKit (Safari) です。
Windows で Microsoft Edge WebView2がインストールされていない場合、4D はシステムのレンダリングエンジンとして埋め込みエンジンを使用します。 システムにインストールされているかどうかを確認するには、アプリケーションパネルで "Microsoft Edge WebView2 Runtime" を検索してください。
- チェックあり -
JSON値: embedded: この場合、4D は Chromium Embedded Framework (CEF) を使用します。 埋め込みWebレンダリングエンジンを使用すると、Webエリアの描画とその動作が (ピクセル単位での若干の相違やネットワーク実装に関連する違いを除き) プラットフォームに関わらず同じになります。 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.
CEFエンジンには以下のような制約があります:
WA SET PAGE CONTENT: using this command requires that at least one page is already loaded in the area (through a call toWA OPEN URLor an assignment to the URL variable associated to the area).- When URL drops are enabled by the
WA enable URL dropselector of theWA SET PREFERENCEcommand, the first drop must be preceded by at least one call toWA OPEN URLor one assignment to the URL variable associated to the area.
ローカルで 4DCEFParameters.json 設定ファイル を作成することで、CEFエリアのパラメーターをカスタマイズできます。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| webEngine | string | "embedded", "system" |