XtOwnSelection(3Xt)

名前
XtOwnSelection, XtOwnSelectionIncremental, 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;

Boolean XtOwnSelectionIncremental(w, selection, time, convert_callback, lose_callback, done_callback, cancel_callback, client_data)
      Widget w;
      Atom selection;
      Time time;
      XtConvertSelectionIncrProc convert_callback;
      XtLoseSelectionIncrProc lose_callback;
      XtSelectionDoneIncrProc done_callback;
      XtCancelConvertSelectionProc cancel_callback;
      XtPointer client_data;

void XtDisownSelection(w, selection, time)
      Widget w;
      Atom selection;
      Time time;

引き数

convert_proc
    セレクションの現在値が要求されたときに呼び出される手続きを指定する。

done_proc
    リクエスタがセレクションを受け取った後に呼び出される手続きを指定する。 所有者がコールバックを必要としない場合には、NULL を指定する。

lose_selection
    ウィジェットがセレクションの所有を失ったときに呼び出される手続きを指定する。 所有者がコールバックを必要としない場合には、NULL を指定する。

selection
    セレクションのタイプを指定するアトムを指定する(例えば、 等)。

time
    セレクションの所有を開始する時間、または所有を放棄する時間の タイムスタンプを指定する。

w   所有者となるウィジェットまたは所有を放棄するウィジェットを指定する。

説明
関数 は、ウィジェットがセレクションを所有しようとしていることをイントリンシ クスのセレクション機構に知らせる。 この関数は、ウィジェットがうまく所有者になれた場合には を返し、なれなかった場合には を返す。 このウィジェットよりも少し後に他のウィジェットがセレクションの所有権を 要求した場合、最初のウィジェットは所有者になれないことがある。 ウィジェットが所有権を失う場合が2つあることに注意せよ。一つは、他のウィ ジェットが後からウィジェットの所有権を求めた場合で、もう一つはウィジェッ トが自発的にセレクションの所有権を放棄した場合である。 最初にウィジェットがセレクションの所有権の取得に失敗した場合、 lose_selection 手続きは呼び出されない点に注意。

手続きは、指定したウィジェットがセレクションの所有を求めていることをイ ントリンシクスのインクリメンタルセレクション機構に知らせる。 この関数は、ウィジェットがうまく所有者になれた場合には を返し、なれなかった場合には を返す。selection, target, time に関する詳しい情報に ついては、Inter-Client Communication Conventions Manual の 2.6 章を参照すること。

を使ってセレクションの所有者となったウィジェットは、 を使ってセレクションの所有権を放棄することができる。

関数 は、指定したウィジェットがセレクションの所有権を失うことを、イントリン シクスのセレクション機構に知らせる。既にセレクションを失っているか、最 初からセレクションを所有していないためにそのウィジェットが現在セレクショ ンを所有していない場合には、 は何もしない。

ウィジェットが を呼んだ後は、このウィジェットがセレクションを所有していた間のタイムス タンプを持つリクエストが後で到着した場合であっても、この変換手続きは呼 ばれない。 しかし、 を呼ぶ前に始まった変換が を呼んだ後に終わった場合は、ウィジェットの done 手続きが呼ばれる。

関連項目
XtAppGetSelectionTimeout(3Xt), XtGetSelectionValue(3Xt)
X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface