名称

XtGetSelectionValue, XtGetSelectionValues - セレクション値を取得する

形式

void XtGetSelectionValue(w, selection, target, callback, client_data, time)
      Widget w;
      Atom selection;
      Atom target;
      XtSelectionCallbackProc callback;
      caddr_t client_data;
      Time time; void XtGetSelectionValues(w, selection, targets, count, callback, client_data, time)
      Widget w;
      Atom selection;
      Atom ∗targets;
      int count;
      XtSelectionCallbackProc callback;
      caddr_t client_data;
      Time time;

引数

callbackセレクション値を得たとき呼び出される コールバックプロシージャを指定します。

client_data指定されたプロシージャが呼び出されたとき、それを渡す引数を指定します。

client_dataターゲットに対してコールバックプロシージャが呼び出されたとき、 それに渡されるクライアントデータ ( 各ターゲットタイプに 1 つずつ ) を指定します。

countターゲットと client_data のリストの長さを指定します。

selection希望する特定のセレクション ( すなわち、 primary か secondary ) を 指定します。

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

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

timeセレクション値が要求された時刻を示す タイムスタンプを指定します。

wこのリクエストを発生しているウィジェットを指定します。

解説

XtGetSelectionValue 関数は、セレクションのターゲットタイプに変換された値を要求します。 指定されたコールバックは、 XtGetSelectionValue が呼ばれた後のある時点で呼び出されます。 たとえば実際に、指定されたコールバックは、 XtGetSelectionValue がリターンする直前か直後に呼ばれていることがあります。 XtGetSelectionValues 関数は、ターゲットタイプのリストおよびクライアントデータのリストを 使い、セレクションの各々のターゲットに変換された現在の値を取り出す ことを除いて、 XtGetSelectionValue と同等です。 その効果はそれぞれのターゲットを個別に XtGetSelectionValue に指定して呼び出したのと同じです。 コールバックは、各ターゲットに対して対応するクライアントデータと ともに、一度ずつ呼び出されます。 XtGetSelectionValues は、すべての変換が同じセレクション値を使うことを必ず保証します。 なぜならば、そのセレクションの所有権は、リストの途中で変化することが できないからですが、一方それは XtGetSelectionValue を繰り返して呼んでいる場合にはおこりえます。

関連事項

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

NEWS-OSRelease 3.3