名称

XmClipboardCopyByName — 名前で渡されたデータ項目をコピーするクリップボード関数

形式

#include <Xm/Xm.h>
#include <Xm/CutPaste.h> int XmClipboardCopyByName (display, window, data_id, buffer, length, private_id)
Display∗ display;
Windowwindow;
intdata_id;
char∗ buffer;
unsigned long length;
intprivate_id;

解説

XmClipboardCopyByName は、以前にクリップボードに名前で渡されたデータ項目に対する実際のデータのコピーをおこないます。 XmClipboardCopy を、引数 buffer を NULL にして呼び出すと、データは名前で渡されたものとみなされます。 この関数をさらに繰り返し呼ぶと、現在のデータに新しいデータが付け加えられます。 この関数を繰り返し呼ぶ場合には、クリップボードのデータがこわされないことを保証するためにクリップボードをロックしなければなりません。 クリップボードをロックするには XmClipboardLock を用いてください。 コピーが完了したときは、XmClipboardUnlock を用いてクリップボードのロックを解除してください。

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

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

data_id 1iデータ項目とフォーマットを一意に識別するためにデータ項目につけられた識別番号を指定します。 この番号は、XmClipboardCopy がデータ項目につけたものです。

bufferバッファを指定します。 ここからクリップボードがデータをコピーします。

lengthデータ項目のバイト数を指定します。

private_idアプリケーションがデータ項目とともに記録したいプライベートデータを指定します。

リターン値

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

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

関連事項

XmClipboardCopy(3XM), XmClipboardLock(3XM), XmClipboardStartCopy(3XM), XmClipboardUnlock(3XM)

NEWS-OSRelease 4.1C