名称

XmClipboardUnlock — クリップボードをアンロックするクリップボード関数

形式

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

解説

XmClipboardUnlock は、クリップボードをアンロックし、他のアプリケーションがクリップボードをアクセスできるようにします。

もし XmClipboardLock の呼び出しが複数回起きていた場合、remove_all_locks が True に設定されていなければ、クリップボードをアンロックするには同じ数だけの XmClipboardUnlock の呼び出しが必要です。

アプリケーションは XmClipboardCopyByName を複数回呼び出す前にクリップボードをロックし、呼び出しが完了したのちクリップボードをアンロックしなければなりません。

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

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

remove_all_locks
True であれば、すべての多重ロックを解除することを示します。 False であれば、1 段だけロックを解除することを示します。

リターン値

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

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

関連事項

XmClipboardCancelCopy(3XM), XmClipboardCopy(3XM), XmClipboardCopyByName(3XM), XmClipboardEndCopy(3XM), XmClipboardEndRetrieve(3XM), XmClipboardInquireCount(3XM), XmClipboardInquireFormat(3XM), XmClipboardInquireLength(3XM), XmClipboardInquirePendingItems(3XM), XmClipboardLock(3XM), XmClipboardRegisterFormat(3XM), XmClipboardRetrieve(3XM), XmClipboardStartCopy(3XM), XmClipboardStartRetrieve(3XM), XmClipboardUndoCopy(3XM), XmClipboardWithdrawFormat(3XM)

NEWS-OSRelease 4.2.1R