名称

XSetSelectionOwner, XGetSelectionOwner, XConvertSelection - セレクショ ンの所有者を処理する

形式

XSetSelectionOwner(display, selection, owner, time)
      Display ∗display;
      Atom selection;
      Window owner;
      Time time; Window XGetSelectionOwner(display, selection)
      Display ∗display;
      Atom selection; XConvertSelection(display, selection, target, property, requestor, time)
      Display ∗display;
      Atom selection, target;
      Atom property;
      Window requestor;
      Time time;

引数

displayX サーバへのコネクションを指定します。

owner指定されたセレクションアトムの所有者を指定します。 ウィンドウまたは None. を指定できます。

propertyプロパティ名を指定します。 None. を指定できます。

requestor要求者を指定します。

selectionセレクションアトムを指定します。

targetターゲットアトムを指定します。

time時間を指定します。
 timestamp か CurrentTime. いずれかを指定できます。

解説

XSetSelectionOwner 関数は、指定されたセレクションの所有者および最終変更時間を変更します。 指定された時間が指定されたセレクションの現在の最終変更時間より 早い場合、または現在の X サーバ時間より遅い場合は、 何の変更もありません。 そうでない場合は、最終の変更時間を指定の時間にセットします。 このとき、 CurrentTime を現在のサーバ時間と置換します。 所有者ウィンドウが None, として指定された場合は、セレクションの所有者は None ( すなわち、所有者なし ) になります。 そうでない場合は、セレクションの所有者は、リクエストを実行している クライアントになります。 新しい所有者 ( クライアントまたは None) が、 セレクションの現在の所有者と同じではなく、 また、現在の所有者が None, でない場合に、現在の所有者へ、 SelectionClear イベントが送信されます。 セレクションの所有者であるクライアントが、後で終了した
 ( すなわち、コネクションがクローズされた ) 場合、 または、そのリクエストで指定されている所有者ウィンドウが後で 破壊された場合は、 セレクションの所有者は自動的に None, に戻るが、最終変更時間は変更されません。
 X サーバはセレクションアトムを解釈しません。 XGetSelectionOwner は、所有者ウィンドウを返し、それは SelectionRequest および SelectionClear イベントで通知されます。 セレクションは X サーバに対しグローバルです。 XSetSelectionOwner は、 BadAtom および BadWindow エラーを生じることがあります。 XGetSelectionOwner 関数は、 現在指定されたセレクションを所有しているウィンドウに対応する ウィンドウ ID を返します。 セレクションが指定されていない場合は、関数は、定数 None. を返します。 None が返された場合は、 セレクションの所有者は存在しません。 XGetSelectionOwner は、 BadAtom エラーを生じることがあります。 XConvertSelection は、指定されたセレクションの、指定されたターゲットタイプへの変換を 要求します。

・指定されたセレクションが所有者をもっている場合は、 X サーバは、 その所有者へ SelectionRequest イベントを送ります。

・指定されたセレクションが所有者をもっていない場合は、
 X サーバは、要求者に対して、プロパティが None の SelectionNotify イベントを発生します。 いずれのイベントにおいても、 引数は変更されないで渡されます。 事前に定義されているセレクションアトムが２つあります。
 PRIMARY と SECONDARY です。 XConvertSelection は、 BadAtom および BadWindow エラーを生じることがあります。

診断

BadAtom Atom 引数の値が定義された Atom を指さない。

BadWindow
Window 引数の値が定義された Window を指さない。

関連事項

Xlib − C Language X Interface

NEWS-OSRelease 4.1C