Channel.IM (読み書き可能) プロパティ (制限付き)
このプロパティは、受信したインスタント メッセージが格納されている String オブジェクトを返します。OnIMReceived イベントの発生時には、必ずこのプロパティに新しいデータが格納されています。ReplaceIM 許可が設定されている場合、OnIMReceived イベントの発生時に、この String の内容を変更してから表示することができます。このメソッドは、アプリケーションに ReplaceIM 許可フラグが設定されている場合のみ使用可能であるため、"制限付き" として扱われます。詳細については、「標準的なアプリケーションと高度なアプリケーション」を参照してください。
VBScript 構文
external.Channel.IM
JavaScript 構文
window.external.Channel.IM
プロパティの値
リモートの Messenger クライアントから受信したインスタント メッセージが格納されている String オブジェクト。
例
下記の例は、インスタント メッセージの変換の例です。
// IM を表示前に変更するには、ReplaceIM 許可フラグが必要です。
var myChannel = window.external.Channel;
function Translate(mySourceText) {
// ここで変換関数を定義します
}
function Channel_OnIMReceived() {
var translated;
translated = Translate( myChannel.IM );
myChannel.IM = translated;
}
解説
このプロパティには、OnIMReceived イベントの発生時に検査が必要なデータが格納されます。
Channel.IM の変更後の内容を会話の履歴ウィンドウに表示するには、OnIMReceived イベントが終了する前に変更を完了する必要があります。