MrmFetchColorLiteral(3XM) — NEWS-OS Programmer’s Manual

名称

MrmFetchColorLiteral — UID ファイルから名前つきのカラーリテラルをフェッチします

#include <Xm/Intrinsics>
#include <Mrm/MrmPublic.h>
int MrmFetchColorLiteral(hierarchy_id, index, display, colormap_id, pixel)

MrmHierarchy hierarchy_id;
String index;
Display ∗display;
Colormap colormap_id;
Pixel ∗pixel;

MrmFetchColorLiteral 関数は uid ファイルから名前つきのカラーリテラルをフェッチし、カラーリテラルをピクセルの色の値に変換します。

hierarchy_id指定されたリテラルを含む uid 階層構造の ID を指定します。 hierarchy_id は MrmOpenHierarchy を呼び出したときのリターン値です。

indexフェッチするカラーリテラルの uil 名を指定します。この名前は uil の中で exported value として定義されていなければなりません。

displayピックスマップに用いるディスプレイを指定します。この引数 display は、X サーバへの結合を指定します。 Display 構造体についての詳細は Xlib 関数の XOpenDisplay を参照してください。

colormap_idカラーマップの ID を指定します。 NULL の場合は、デフォルトのカラーマップが用いられます。

pixelカラーリテラルの ID が返されます。

この関数は、状態を示す以下の定数のうちのいずれかを返します。

MrmSUCCESS関数が正常に実行された。

MrmNOT_FOUND
UIL ファイルの中にカラーリテラルが見つからなかった。

MrmFAILURE関数の実行が失敗した。