WA GET URL HISTORY
WA GET URL HISTORY ( {* ;} object ; urlsArr {; direction {; titlesArr}} )
| 引数 | 型 | 説明 | |
|---|---|---|---|
| * | 演算子 | → | 指定時, objectはオブジェクト名 (文字列) 省略時, objectは変数 |
| object | any | → | オブジェクト名 (* 指定時) または 変数 (* 省略時) |
| urlsArr | Text array | ← | 訪問したURLの配列 |
| direction | Integer | → | 0または省略=前のURL配列, 1=次のURL配列 |
| titlesArr | Text array | ← | ウィンドウタイトルの配列 |
このコマンドはスレッドセーフではないため、プリエンプティブなコードには使えません。
説明
WA GET URL HISTORY コマンドは、* と object 引数で指定したWebエリアのセッション中に訪問したURLを含む1つまたは2つの配列を返します。このコマンドを使用して、カスタムのナビゲーションシステムを作成できます。
提供される情報はセッションに限定されます。言い換えればナビゲーションは同じWebエリアで、フォームが閉じられない間実行されます。
urlsArr 配列には、訪問したURLが返されます。direction 引数が渡されればその値に基づき、配列に前のURL (デフォルト動作)、または次のURLが返されます。これらのリストは、ブラウザの標準の次ページや前ページの内容に対応します。
URLは時間順に並びかえられます。
directionには取得するリストを指定する値を渡します。 Web Area テーマの以下の定数を使用できます:
| 定数 | 型 | 値 |
|---|---|---|
| WA next URLs | 倍長整数 | 1 |
| WA previous URLs | 倍長整数 | 0 |
direction 引数を省略すると、0が使用されます。
titlesArr 引数を渡すと、URLに関連付けられたウィンドウの名前が返されます。この配列はurlsArr 配列と同期しています。
互換性に関する注意: *4D v19 R5 以降、このコマンドは Windows のシステムレンダリングエンジン を使用しているWeb エリアにおける urlsArr および titlesArr 配列のみを返します。