XmInstallImage(3XM) — NEWS-OS Programmer’s Manual
名称
XmInstallImage — ピックスマップキャッシュにイメージを追加するピックスマップキャッシング関数
形式
#include <Xm/Xm.h> Boolean XmInstallImage (image, image_name )
XImage∗ image ;
char∗ image_name ;
解説
XmInstallImage は、後にピックスマップを生成するために使うイメージキャッシュの中に、イメージを記憶します。 インストールプロセスの一部は、これらのイメージを参照するために使用するリソースコンバータを拡張します。 リソースコンバータには、イメージが .Xdefaults ファイル中で参照できるように、イメージ名が与えられます。 イメージは widget がピックスマップリソースを通じて参照するため、アプリケーションが widget を生成する前にイメージを確実にインストールしていなければなりません。
imageインストールされるイメージ構造体を指定します。 インストールプロセスは、イメージの局所的なコピーを作りません。 そのためアプリケーションは、イメージがキャッシング関数から消去されるまで、イメージを消去することはできません。
image_nameアプリケーションがイメージに名前を付けるのに使う文字列を指定します。 インストール後、この名称を .Xdefault 中で使ってイメージを参照することができます。 名称の局所的なコピーは、イメージキャッシング関数によって生成されます。
イメージキャッシング関数では、8 つのイメージがあらかじめインストールされています。 イメージ名は、.Xdefault ファイル中で使用して、これらが用意されているリソースに対するピックスマップを生成することができます。
| イメージ名 | 解説 |
| background | すべてがバックグラウンドのタイル |
| 25_foreground | 25% がフォアグラウンド、75% がバックグラウンドのタイル |
| 50_foreground | 50% がフォアグラウンド、50% がバックグラウンドのタイル |
| 25_foreground | 75% がフォアグラウンド、25% がバックグラウンドのタイル |
| horizontal | 2 色の水平線のタイル |
| vertical | 2 色の垂直線のタイル |
| slant_right | 2 色の斜線のタイル |
| slant_left | 2 色の斜線のタイル |
リターン値
成功した場合は、True を返します。 image や image_name が NULL であるか、あるいはパラメータとして同一の image_name を複数回使用した場合、False を返します。
関連項目
XmUninstallImage(3XM), XmGetPixmap(3XM), XmDestroyPixmap(3XM)
NEWS-OSRelease 4.2.1R