XSetSelectionOwner(3X11)

名前
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;

引き数

display
    X サーバへの接続を指定する。

owner
    指定されたセレクションアトムの所有者を指定する。 ウィンドウか を渡すことができる。

property
    プロパティ名を指定する。 を渡すこともできる。

requestor
    要求者を指定する。

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

target
    ターゲットのアトムを指定する。

time
    時間を指定する。 タイムスタンプか を渡すことができる。 関数 は、指定したセレクションの所有者と最終更新時間を変更する。 指定した時間が、指定したセレクションの現在の最終更新時間よりも早い場合や X サーバの現在時刻よりも遅い場合には、この関数は何もしない。 そうでない場合には、最終更新時間は指定された時間にセットされ、 はXサーバの現在時刻に置き換えられる。 所有者のウィンドウに が指定された場合には、セレクションの所有者は (つまり所有者無し)となる。 そうでない場合、セレクションの所有者は要求を行ったクライアントになる。

もし新しい所有者(クライアントか が、現在のセレクション所有者と異なり、かつ現在の所有者が でなければ、現在の所有者には イベントが送られる。 セレクションの所有者になっているクライアントが後で終了した(つまり接続 が閉じた)か、リクエストで指定された所有者のウィンドウが後で破棄された 場合には、セレクションの所有者は自動的に に戻るが、最終更新時間はこの影響を受けない。 セレクションのアトムは X サーバには解釈されない。 は所有者のウィンドウを返すが、これは および イベントで通知される。 セレクションは X サーバにおいて大域的に扱われる。

はエラー あるいは を起こすことがある。

関数 は、指定したセレクションを現在所有しているウィンドウに関連づけられたウィ ンドウIDを返す。 セレクションが指定されていない場合には、関数は定数 を返す。 もし が返された場合、セレクションの所有者はいない。

はエラー を起こすことがある。

は、指定したセレクションが指定した型に変換されることを要求する。

•   指定したセレクションに所有者がいる場合、X サーバは をその所有者に送る。

•   指定されたセレクションの所有者がいない場合、X サーバは プロパティに を設定して イベントを要求者に送る。

引き数はいずれのイベントでも変更されずに送られる。 予め定義されているアトムとしては PRIMARY と SECONDARY の2つがある。

はエラー を起こすことがある。

返り値

引き数 Atom に対する値が、定義されている Atom を指していない。

引き数 Window に対する値が、定義されている Window を指していない。

関連項目
Xlib - C Language X Interface