名称

XmClipboardUndoCopy — クリップボードに置かれた最後の項目を削除するクリップボード関数

形式

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

解説

XmClipboardUndoCopy は、クリップボードにある最後の項目が渡された引数 display と window を持っているアプリケーションによって置かれた物だった場合、その項目を削除します。 もとの XmClipboardCopy の呼び出しによって、クリップボードから削除されたデータ項目はすべて復帰します。 もし display や window の ID が最後にコピーされた項目と一致しなければ、何も行われず、この関数はなんの影響も起こしません。

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

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

リターン値

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

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

関連事項

XmClipboardLock(3XM), XmClipboardStartCopy(3XM)

NEWS-OSRelease 4.1C