名称

XmClipboardInquireCount — データ項目フォーマットの数を返すクリップボード関数

形式

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

解説

XmClipboardInquireCount は、クリップボード中のデータ項目に対して使用できるデータ項目フォーマットの数を返します。 この関数は、このデータ項目が格納されているすべてのフォーマットについての名前の最大長も返します。

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

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

countクリップボード中のデータ項目に対して使用できるデータ項目フォーマットの数を返します。 使用できるフォーマットがまったくない場合はこの引数はゼロです。 この数には名前で渡されたフォーマットも含みます。

max_format_name_length
クリップボード中のデータ項目のすべてのフォーマットの名前の最大長を示します。

リターン値

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

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

ClipboardNoData要求されたフォーマットに対応するデータが、クリップボードに見つかりませんでした。 このことは、クリップボードが空であるか、クリップボードにデータはあるが要求されたフォーマットでは存在しなかったか、要求されたフォーマットのデータが名前で渡されたものですでに利用できないような場合に起きます。

関連事項

XmClipboardStartCopy(3XM)

NEWS-OSRelease 4.2.1R