XCreateOC(3X11)

名前
XCreateOC, XDestroyOC, XSetOCValues, XGetOCValues, XOMOfOC - 出力コンテクスト(output context)の生成

書式
XOC XCreateOC(om, ...)
      XOM om;

void XDestroyOC(oc)
      XOC oc;

char * XSetOCValues(oc, ...)
      XOC oc;

char * XGetOCValues(oc, ...)
      XOC oc;

XOM XOMOfOC(oc)
      XOC oc;

引き数

oc  出力コンテクストを指定。

om  出力メソッドを指定。

... XOC 値を設定あるいは取得するため可変長引き数リストを指定。

説明
関数 は、指定した出力メソッド内に出力コンテクストを生成する。

ベースフォント名の引き数は出力コンテクストの生成時には必須であり、これが 与えられない限り出力コンテクストは生成されない。 他の出力コンテクスト値は後から設定することができる。

は出力コンテクストが生成できなかった場合、NULL を返す。 NULL が返されるのは以下の原因による。

•   必要な引き数がセットされていない。

•   リードオンリーの引き数がセットされた。

•   引き数の名前が認識できない。

•   出力メソッドが、出力メソッドの実装依存のエラーに出会った。

関数 は指定した出力コンテクストを破棄する。

関数 はエラーが発生しなかった場合に NULL を返す。 そうでない場合、セットできなかった最初の引き数の名前が返される。 引き数がセットできない場合は、以下の原因が考えられる。

•   引き数がリードオンリーである。

•   引き数の名前が認識できない。

•   実装依存のエラーが発生した。

セットされる値は、引き数の意味によって決まるデータ型に適合するデータでな ければならない。

関数 はエラーが発生しなければ NULL を返す。そうでない場合、 取得することができなかった最初の引き数の名前を返す。 引き数が取得できない場合は以下の原因が考えられる。

•   引き数の名前が認識できない。

•   実装依存のエラーが発生した。

引き数の名前に続く値はそれぞれ値が格納される場所を指すポインタでなければ ならない。

関数 は指定された出力コンテクストに対応する出力メソッドを返す。

関連項目
XCreateOM(3X11), XCreateFontSet(3X11)
Xlib - C Language X Interface