4D v20.1
WA Run offscreen area
- ランゲージリファレンス
-
- Webエリア
-
- Webエリアのプログラムによる管理
- WA Back URL available
- WA Create URL history menu
- WA Evaluate JavaScript
- WA EXECUTE JAVASCRIPT FUNCTION
- WA Forward URL available
- WA Get current URL
- WA GET EXTERNAL LINKS FILTERS
- WA Get last filtered URL
- WA GET LAST URL ERROR
- WA Get page content
- WA Get page title
- WA GET PREFERENCE
- WA GET URL FILTERS
- WA GET URL HISTORY
- WA OPEN BACK URL
- WA OPEN FORWARD URL
- WA OPEN URL
- WA OPEN WEB INSPECTOR
- WA REFRESH CURRENT URL
- WA Run offscreen area
- WA SET EXTERNAL LINKS FILTERS
- WA SET PAGE CONTENT
- WA SET PREFERENCE
- WA SET URL FILTERS
- WA STOP LOADING URL
- WA ZOOM IN
- WA ZOOM OUT
WA Run offscreen area
| WA Run offscreen area ( parameters ) -> 戻り値 | ||||||||
| 引数 | 型 | 説明 | ||||||
| parameters | オブジェクト |
|
Web エリアの属性を格納したオブジェクト | |||||
| 戻り値 | Mixed |
|
コールバックメソッドによって返された値 | |||||
WA Run offscreen area コマンドは、メモリ内にWeb エリアを作成します。このWeb エリアはWeb ページを自動的に読み込んで解析することなどに使用できます。
注: このコマンドは埋め込みWeb レンダリングエンジンを使用します。
parameters オブジェクト引数には、Web エリアの以下の任意の属性のいずれかを渡すことができます。これらのプロパティはonEvent メソッド内のThis コマンドを通して利用可能で、これによりインスタンスを参照することができます:
| プロパティ | 型 | 詳細 |
| url | テキスト | fileオブジェクト | Web エリアに読み込まれるURL またはファイル。省略時またはnull の場合、空のページが読み込まれます。 |
| area | テキスト | Web エリア名。省略時またはnull の場合、汎用的な名前(例: OffscreenArea1)が割り当てられます。 |
| onEvent | オブジェクト(フォーミュラ) | Web エリアの準備ができたときにローンチされるコールバックメソッド。以下のどちらかを使用できます:
|
| autoQuit | ブール | True(デフォルト値)の場合、On End URL Loading または On URL Loading Error イベントが発生したときにはコマンドはフォーミュラの実行を中止します。 Falseの場合、Web エリアを閉じるためには呼び出されたCANCEL または ACCEPT コールバックメソッドまたはプロジェクトメソッド内においてコマンドを$4d オブジェクトとともに使用する必要があります。 |
| timeout | 実数 | イベントが何も生成されなければエリアが自動的に閉じてしまうまでの最大時間(秒単位)。0 設定された場合、制限は適用されません。デフォルトの値: 60 |
| result | (任意) | 返す処理の結果(あれば) |
| <customProperty> | (任意) | コールバックまたは$4d メソッド内で利用可能なカスタムの属性 |
以下のプロパティは、必要であればコマンドによって自動的に追加されます:
| プロパティ | 型 | 詳細 |
| timeoutReached | ブール | タイムアウトを超過した場合には、true の値を持って追加されます。 |
渡されたparameter オブジェクト引数がnull だった場合、空のWeb エリアが開かれてそして自動的に閉じられます。
注:
- オフスクリーンのWeb エリアは、WA Run offscreen area コマンドの実行中にのみ利用可能です。実行が終了すればそのWeb エリアは自動的に閉じられます。
- 4D メソッドはWeb エリア内にて実行されるJavaScript コードから呼び出し可能です。詳細は4Dメソッドへのアクセスを参照して下さい。
自分のOffscreenArea クラスのファンクションを使用して、オフスクリーンのWeb エリアを作成し管理したい場合を考えます:
$config:=cs.OffscreenArea.new()
$result:=WA Run offscreen area($config)
If($config.timeoutReached) // タイムアウト時には自動的に返される
ALERT("Timeout reached")
End ifOffscreenArea クラス内のコード:
Class constructor
This.url:=File("/RESOURCES/compute.html")
This.area:="myWAOffscreen"
Function onEvent
Case of
:(FORM Event.code=On End URL Loading)
This.result:=WA Evaluate JavaScript(*;This.area;"myJSMethod();")
End caseタイムアウトに達した場合、またはonEvent でCANCEL が呼び出された場合、OK システム変数は0に設定され、それ以外の場合には1に設定されます。
プロダクト: 4D
テーマ: Webエリア
番号:
1727
初出: 4D v18 R3
変更: 4D v18 R6
ランゲージリファレンス ( 4D v20)
ランゲージリファレンス ( 4D v20.1)
