@DDEPoke (式言語)

要求への応答ではないデータを、DDE サーバーアプリケーション内の指定された場所に格納します。データが指定の位置に正しく挿入された場合は、ACK (肯定応答) と値 @True(1) が返されます。この試みが成功しなかった場合は、NACK (否定応答) と値 @False(0) が返されます。接続 ID が無効な場合は、エラーが返されます。@IsError を参照してください。

注: DDEPoke は UNIX と Macintosh ではサポートされていません。

構文

@DDEPoke( conversationID ; location ; data )

パラメータ

conversationID

conversationID には、@DDEInitiate で返された ID を指定します。

location

文字列。data を挿入する場所の名前を指定します。セル、範囲、フィールド名のいずれかを引用符で囲んで指定します。

data

文字列。オプション。location に挿入するデータを指定します。文字列以外のフィールドの内容を渡す場合は、先に @Text を使用して文字列に変換します。data が文字列リストの場合は、リストの最初の値だけがアプリケーションに渡されます。data を省略した場合は、Windows のクリップボードの内容が受信側のアプリケーションに渡されます。データをパラメータとして指定する場合は、引用符で囲むか、Domino のフィールド名を指定します。

使用法

この関数は、主にフィールド式、エージェント、ツールバーボタンで使用します。Macintosh は DDE に対応していないため、DDE コマンドは Macintosh クライアント上では使用できません。この関数は列式や選択式では使用できません。また、ウィンドウタイトル式やフォーム式でも使用できません。

ユーザーの NOTES.INI ファイルに次のステートメントが含まれている場合は、

NoExternalApps=1

@DDE 関数を使用する式はすべて無効になります。この場合、式が失敗するだけでエラーメッセージは表示されません。

この関数は、Web アプリケーションでは使用できません。

@DDEExecute を参照してください。