名称

XSaveContext, XFindContext, XDeleteContext, XUniqueContext - 結合ルックアップルーチン

形式

int XSaveContext(display, w, context, data)
      Display ∗display;
      Window w;
      XContext context;
      caddr_t data; int XFindContext(display, w, context, data_return)
      Display ∗display;
      Window w;
      XContext context;
      caddr_t ∗data_return; int XDeleteContext(display, w, context)
      Display ∗display;
      Window w;
      XContext context; XContext XUniqueContext()

引数

contextデータが属するコンテキストの型を指定します。

dataウィンドウおよび型と対応するデータを指定します。

data_returnデータを指すポインタを返します。

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

wデータと対応するウィンドウを指定します。

解説

指定されたウィンドウおよび型をもつエントリが、すでに存在する場合は、 XSaveContext は、そのエントリを指定されたコンテキストでオーバライドします。 XSaveContext 関数は、エラーが生じた場合は、非零のエラー・コードを、 逆の場合は零を返します。 XCNOMEM ( メモリ外 ) エラーが生じることがあります。 それはリターン値なので、データはポインタです。 XFindContext 関数は、エラーが生じた場合は非零のエラー・コードを、 逆の場合は、零を返します。 XCNOENT ( コンテキストが見つからない ) エラーが生じることがあります。 XDeleteContext 関数は、与えられたウィンドウおよび型についてのエントリを、 データ構造体から削除します。 XDeleteContext 関数は、同じ引数を用いて呼び出された場合、 XFindContext が返すエラーコードと同じエラーコードを返します。 XDeleteContext は、アドレスがセーブされているデータを解放しません。 XUniqueContext 関数は、 XSaveContext に対して続いて起る呼び出しで使用してもよい一意のコンテキストの型を 作成します。

関連事項

Xlib − C Language X Interface

NEWS-OSRelease 4.1C