名称

XmClipboardInquirePendingItems — data_id/private_id の組のリストを返すクリップボード関数

形式

#include <Xm/Xm.h>
#include <Xm/CutPaste.h> int XmClipboardInquirePendingItems (display, window, format_name, item_list, count)
Display∗ display;
Windowwindow;
char∗ format_name;
XmClipboardPendingList ∗ item_list;
unsigned long∗ count;

解説

XmClipboardInquirePendingItems は、指定したフォーマット名の data_id/private_id の組のリストを返します。 アプリケーションが初めにあるデータ項目を名前で渡していて、アプリケーションがまだそのデータをコピーしておらず、しかもその項目がクリップボードから削除されていないとき、 そのデータ項目は未決定 (pending) であるとみなされます。 リストを格納するためにこの関数によって提供されたメモリは、アプリケーションの責任で解放しなければなりません。

この関数は、 exit するときに、アプリケーションが名前で渡したデータをクリップボードに送るかどうかを決定するために使われます。

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

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

format_namedata ID/private ID の組のリストを得るフォーマットの名前を表す文字列を指定します。

item_list指定したフォーマット名についての data ID/private ID の組の配列のアドレスを示します。 この引数の型は XmClipboardPendingList です。 リストを格納するためにこの関数によって提供されたメモリは、アプリケーションの責任で解放しなければなりません。

item_countリストで返された項目の数を示します。 指定されたフォーマット名のデータがなかった場合や、クリップボードに項目がなかった場合は、ゼロです。

リターン値

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

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

関連事項

XmClipboardStartCopy(3XM)

NEWS-OSRelease 4.2.1R