API version 11
- ‐
postInterContextMessage¶
コンテキスト(タブ)を跨いでメッセージを送信します。
メッセージは該当するコンテキストのRootオブジェクトに InterContextMessage イベントとして通知されます。
オプション指定により他のBiz/Browser DTプロセスのコンテキストに対しても送信可能です。
呼出形式一覧
呼出形式 |
説明 |
---|---|
integer postInterContextMessage(string contextId, param) |
指定のコンテキストIDのコンテキストにparamを送信します。 |
integer postInterContextMessage(string serviceId, string portId, param[, boolean enableInterProcessMessaging]) |
指定のサービスID, ポートIDのコンテキストにparamを送信します。 enableInterProcessMessagingにtrueを指定時は次のように動作します。
|
戻り値一覧
戻り値 |
説明 |
---|---|
integer |
enableInterProcessMessagingがfalse、または省略した場合は送信できたコンテキスト(タブ)の数が返ります。 また、送信先が発見できなかった場合、0が返ります。 enableInterProcessMessagingがtrueの場合は送出対象したプロセス数が返ります。 基本的に自身を含む起動中のBiz/Browser DTのインスタンス数となります。 |
引数一覧
引数 |
説明 |
---|---|
contextId |
送信先コンテキストIDを指定します。 |
param |
受信先イベント(後述)に付与されるパラメータを指定します。
Mapオブジェクトまたはbinary値を渡すことが可能です。
Mapオブジェクトが渡された場合、Mapオブジェクトの値をbinary値に変換したものが実際に送信されます。
Mapオブジェクトが空の場合、送信すべきデータがないためメッセージは送信されません。
binary値を渡した場合、キー"body"に当該binary値がセットされたMapオブジェクトが送信されます。
|
serviceId |
送信先サービスIDを指定します。 |
portId |
送信先ポートIDを指定します。 |
enableInterProcessMessaging |
プロセスを跨いでメッセージを送信するかどうかを指定します。 |
例外
識別子 |
説明 |
---|---|
SYS-23:5 |
メソッドの引数が不正です |
CRS::Common::Core::Application-1:1 |
宛先が曖昧です |
関連項目