API version 1
- 11
postInterContextMessage¶
コンテキスト(タブ)を跨いでメッセージを送信します。
メッセージは該当するコンテキストのRootオブジェクトに InterContextMessage イベントとして通知されます。
他のBiz/Browser DTプロセスのコンテキストに対しての送信はできません。
他のプロセスへの送信が必要な場合 EventSender クラス、 EventListener クラスが利用可能です。
呼出形式一覧
呼出形式 |
説明 |
---|---|
integer postInterContextMessage(string contextId, param) |
指定のコンテキストIDのコンテキストにparamを送信します。 |
integer postInterContextMessage(string serviceId, string portId, param) |
指定のサービスID, ポートIDのコンテキストにparamを送信します。 |
戻り値一覧
戻り値 |
説明 |
---|---|
integer |
送信できたコンテキスト(タブ)の数が返ります。 送信先が発見できなかった場合、0が返ります。 |
引数一覧
引数 |
説明 |
---|---|
contextId |
送信先コンテキストIDを指定します。 |
param |
受信先イベント(後述)に付与されるパラメータを指定します。
Mapオブジェクトまたはbinary値を渡すことが可能です。
Mapオブジェクトが渡された場合、Mapオブジェクトの値をbinary値に変換したものが実際に送信されます。
Mapオブジェクトが空の場合、送信すべきデータがないためメッセージは送信されません。
binary値を渡した場合、キー"body"に当該binary値がセットされたMapオブジェクトが送信されます。
|
serviceId |
送信先サービスIDを指定します。 |
portId |
送信先ポートIDを指定します。 "*"を指定することで、同一のサービスIDを持つコンテキスト(タブ)に送信します。 |
例外
識別子 |
説明 |
---|---|
SYS-23:5 |
メソッドの引数が不正です |
CRS::Common::Core::Application-1:1 |
宛先が曖昧です |
関連項目
getCurrentContextInfo、 setCurrentContextInfo メソッド
使用例
CRSダウンロード
Form Application_postInterContextMessage {
x = 0;
y = 0;
width = 800;
height = 600;
Button button1 {
x = 40;
y = 40;
width = 216;
height = 72;
title = "他のタブをアクティブにする";
function onTouch(e) {
# 他のコンテキストにメッセージを送信
var param = new Map;
param["command"] = "activate";
Application.postInterContextMessage("AppMessage", "id001", param);
}
}
}