XtGetSelectionValueIncremental(3Xt)

名前
XtGetSelectionValueIncremental, XtGetSelectionValuesIncremental - セレクション値の取得

書式
void XtGetSelectionValueIncremental(w, selection, target, callback, client_data, time)
      Widget w;
      Atom selection;
      Atom target;
      XtSelectionCallbackProc callback;
      XtPointer client_data;
      Time time;

void XtGetSelectionValuesIncremental(w, selection, targets, count, callback, client_data, time)
      Widget w;
      Atom selection;
      Atom *targets;
      int count;
      XtSelectionCallbackProc callback;
      XtPointer client_data;
      Time time;

引き数

callback
    セレクション値が既に取得されていたときに呼び出されるコールバック手続き を指定。

client_data
    指定された手続きが呼び出されたとき、この手続きに渡される引き数を指定。

client_data
    コールバックの手続きが目的のタイプに対して呼ばれたときに、この手続きに 渡されるクライアントデータを指定(それぞれの目的タイプに対して1つ)。

count
    引き数 targets と client_data のリストの長さを指定。

selection
    必要な特定のセレクションを指定(つまり、プライマリまたはセカンダリであ る)。

target
    セレクションについて必要な情報のタイプを1つを指定。

targets
    セレクションについて必要な情報のタイプを複数個指定。

time
    セレクション値が必要なときを示すタイムスタンプを指定。

w   リクエストを発行するウィジェットを指定。

説明
関数 は とほぼ同じである。ただし、複数に分割されたセレクション値の一部が届くた びに selection_callback 手続きが繰り返し呼ばれる点だけが異なる。 セレクション値の終わりは、長さがゼロの NULL でない値を使って selection_callback が呼ばれたときである。長さがゼロであっても、 クライアントはこの値を解放しなければならない。(例えばタイムアウト等に より)転送が途中で失敗した場合、シンボル定数 に等しいタイプ値を使って selection_callback 手続きが呼び出される。 これによりリクエスタは、その時点まで集められていたセレクションの断片を 処分することができる。 を受け取った場合は、リクエストを出したクライアントは部分的にしか終わっ ていない転送に意味があるかどうかを決めなくてはならない。

関数 は、 とほぼ同じである。ただし、この関数は目的とするタイプのリストと、クライ アントデータのリストを引き数に取り、それぞれの目的タイプに変換されたセレ クション値を取得する。 この関数の実行結果は、別々の の呼び出しにおいて目的タイプをそれぞれ指定した場合と同様になる。 それぞれの目的タイプについて、コールバックは対応するクライアントデータ を使って1度呼び出される。 は、全ての変換において同じセレクション値が使われることを保証する。 なぜならば、 を繰り返し呼んだときのように、セレクションの所有者がリストの途中で変わ ることはあり得ないからである。

関連項目
X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface