名称

XtOwnSelection, XtDisownSelection − セレクションの所有者を設定する

形式

Boolean XtOwnSelection(w, selection, time, convert_proc, lose_selection, done_proc)
      Widget w;
      Atom selection;
      Time time;
      XtConvertSelectionProc convert_proc;
      XtLoseSelectionProc lose_selection;
      XtSelectionDoneProc done_proc; void XtDisownSelection(w, selection, time)
      Widget w;
      Atom selection;
      Time time;

引数

convert_proc誰かがセレクションの現在の値を要求するときはいつでも呼び出される プロシーシジャを指定します。

done_proc要求者がセレクションを受取った後で呼び出されるプロシージャを指定します。 所有者がコールバックされることに興味を示さない場合は NULL を指定します。

lose_selection
ウィジェットがセレクションの所有権を損失したときはいつでも呼び出される プロシージャを指定します。 所有者がコールバックされることに興味を示さない場合は NULL を指定します。

selectionセレクションの型を記述するアトムを指定します（たとえば、 XA_PRIMARY、 XA_SECONDARY、 または XA_CLIPBOARD ）。

timeセレクションの所有権をいつ始めるか、またはいつ終わる 予定なのかを示す タイムスタンプを指定します。

w所有者になることを願うウィジェット、または所有をやめたいと願う ウィジェットを指定します。

解説

XtOwnSelection 関数は、 Intrinsics セレクションメカニズムに、 ウィジェットがセレクションを所有したいと思っているということを 知らせます。 ウィジェットがうまく所有者になれた場合は、 True を、そうでない場合は、 False を返します。 すでにある他のウィジェットが、このウィジェットより後の時刻に セレクションを所有することを主張している場合は、 ウィジェットは所有者になりそこなうかもしれません。 ウィジェットがセレクションの所有権を失うのは、他のウィジェットが セレクションの所有権を主張したときか、 ウィジェットが自発的にセレクションの所有権を放棄したときの いづれかであることに注意してください。 また、 Lose_selection プロシージャは、 ウィジェットが最初の場所でセレクションの所有権の取得に失敗した場合は、 呼び出されないことにも注意してください。 XtDisownSelection 関数は、 Intrinsics セレクションメカニズムに、 指定されたウィジェットがセレクションの所有権を失うことを知らせます。 セレクションを失ったという理由、または最初からセレクションをもったことが ないという理由のいずれかにより、現在セレクションを所有していない場合は、 XtDisownSelection は何もしません。 ウィジェットが、 XtDisownSelection を呼び出した後で、 その変換プロシージャ (done_proc) は、 たとえこのウィジェットがセレクションを所有している期間の間に、 タイムスタンプをもつリクエストが後で到着したとしても、呼び出されません。 ただし、 done プロシージャ (done_proc) は、 XtDisownSelection へのコールの前に開始された変換が、 XtDisownSelection へのコールの後で終了した場合は、呼び出されます。

関連事項

XtAppGetSelectionTimeout(3Xt), XtGetSelectionValue(3Xt)
X Toolkit Intrinsics − C Language Interface
Xlib − C Language X Interface

NEWS-OSRelease 3.3