名称

XmClipboardEndCopy — クリップボードへのコピーを終了するクリップボード関数

形式

#include <Xm/Xm.h>
#include <Xm/CutPaste.h> int XmClipboardEndCopy (display, window, item_id)
Display∗ display;
Windowwindow;
longitem_id;

解説

XmClipboardEndCopy は、別のアプリケーションのアクセスからクリップボードをロックし、データをクリップボードデータ構造体に置いて、クリップボードのロックを解除します。 XmClipboardCopy によってクリップボードにコピーされたデータは、XmClipboardEndCopy が呼び出されるまでは実際にはクリップボードデータ構造体に入っていません。

この関数は XmClipboardStartCopy によって割り当てられたテンポラリ領域も解放します。 XmClipboardStartCopy は XmClipboardEndCopy より前に呼び出さなければなりません。 XmClipboardCancelCopy が呼び出された場合は、XmClipboardEndCopy 関数は呼び出さないでください。

displayXOpenDisplay または XtDisplay の呼び出しで返された Display 構造体へのポインタを指定します。

windowアプリケーションウィンドウをクリップボードに関係づけるための widget のウィンドウ ID を指定します。 widget のウィンドウ ID は XtWindow を用いることにより得られます。 同じアプリケーションインスタンスは、呼び出す各クリップボード関数に対して同じウィンドウ ID を渡さなければなりません。

item_idこのデータ項目につけられた番号を指定します。 この番号は XmClipboardStartCopy の呼び出しで返されます。

リターン値

ClipboardSuccess
関数の実行に成功しました。

ClipboardLocked
クリップボードが他のアプリケーションにロックされているため、関数の実行に失敗しました。 アプリケーションはロックが解除されるまで同じ引数で何度も関数を呼び続けることができます。 このことを利用して、アプリケーションはユーザに操作を試み続けるかあきらめるかたずねることができます。

関連事項

XmClipboardCancelCopy(3XM), XmClipboardCopy(3XM), XmClipboardStartCopy(3XM)

NEWS-OSRelease 4.1C