名称

XmClipboardWithdrawFormat — アプリケーションがもはやデータ項目を供給したくないことを示すクリップボード関数

形式

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

解説

XmClipboardWithdrawFormat は、アプリケーションが以前に名前で渡したデータ項目を、もはやクリップボードに供給しないことを示します。

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

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

data_idデータ項目とフォーマットを一意に識別する、データ項目に割り当てられた識別番号を指定します。 これは項目が XmClipboardCopy で最初に渡された時に項目に割り当てられます。

リターン値

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

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

関連事項

XmClipboardCopy(3XM), XmClipboardStartCopy(3XM)

NEWS-OSRelease 4.2.1R