XtSetSelectionParameters

Section: XT FUNCTIONS (3Xt)
Updated: Release 6.3
Index xjman/web INDEX

名前

XtSetSelectionParameters - 単独対象のセレクションリクエストに対して、対象パラメータを指定する

書式

void XtSetSelectionParameters(requestor, selection, type, value, length, format)

      Widget requestor;

      Atom selection;

      Atom type;

      XtPointer value;

      unsigned long length;

      int format;

引き数

requestor: リクエストを生成したウィジェットを指定。Core クラスかそのサブクラスでなければならない。
selection: セレクションを示すアトムを指定。
type: パラメータを渡すプロパティのタイプを指定。
value: パラメータへのポインタを指定。
length: value に含まれるデータの要素数を指定。各要素のサイズは format で示される。
format: value の要素に含まれるデータのサイズをビット単位で指定。

説明

リクエスタのウィンドウ上で、指定されたパラメータは指定されたタイプとフォーマットである新しいアトムにコピー・格納される。これに続いて、対象とこれらのパラメータを使うセレクションリクエストを行うため、同じリクエスタウィジェットとセレクションアトムを使った XtGetSelectionValue または XtGetSelectionValueIncremental の呼び出しによって、パラメータを持つプロパティを参照する ConvertSelection リクエストが生成される。リクエストを指定した呼び出しを行なうことなく、同じウィジェットとセレクションを使って XtSetSelectionParameters を複数回呼んだ場合、最も新しいパラメータ指定が以降のリクエストで使われる。

format が取ることができる値は8, 16, 32 である。 format が 8 ならば、value の要素の大きさは sizeof(char) と仮定される。同様に値が 16 ならば sizeof(short), 32 ならば sizeof(long) と仮定される。

セレクションリクエストの複数の対象に対して、パラメータを使った複数対象リクエストを生成するためには、対応する XtSetSelectionParameters の個別の呼び出しよりも前に XtGetSelectionValue と XtGetSelectionValueIncremental の個別の呼び出しを行い、これら全体を XtCreateSelectionRequest と XtSendSelectionRequest で囲むこと。 XtGetSelectionValues と XtGetSelectionValuesIncremental は、パラメータ付きの対象を使ってセレクションリクエストを作るために使うことはできない。

This document was created by man2html, using the manual pages.
Time: 15:56:37 GMT, February 12, 2001

XtSetSelectionParameters

名前

書式

引き数

説明

関連項目

Index