関数

XAllocClassHint, XSetClassHint, XGetClassHint, XClassHint − クラスヒント構造体を割り当て、ウィンドウのWM_CLASS属性を設定または読む。

シンタックス

XClassHint ∗XAllocClassHint() XSetClassHint(display, w, class_hints)
      Display ∗display;
      Window w;
      XClassHint ∗class_hints; Status XGetClassHint(display, w, class_hints_return)
      Display ∗display;
      Window w;
      XClassHint ∗class_hints_return;

引き数

displayXサーバへの接続を指定します。

class_hintsXClassHint 構造体を指定します。

class_hints_return
XClassHint 構造体を返します。

wウィンドウを指定します。

解説

XAllocClassHint 関数は XClassHint 構造体へのポインタを割り当て、返します。 XClassHint 構造体のポインタフィールドはナルに初期設定されていること。 メモリに必要な領域が不足する場合、 XAllocClassHint はナルを返します。 この構造体に割り当てるメモリを解放するには、 XFree を使います。 XSetClassHint 関数は、指定したウィンドウのクラスヒントを設定します。 XSetClassHint で発生するエラーには、 BadAlloc および、 BadWindow エラーがあります。 XGetClassHint 関数は、指定したウィンドウのクラスを返します。 文字列を伴って終了したときのres_nameとres_classを解放するには、 XFree を使います。 XGetClassHint で発生するエラーには BadWindow エラーがあります。

属性

WM_CLASS ウィンドウマネージャおよびセッションマネージャがリソースデータべースの中のアプリケーション用のリソースを獲得するように、 アプリケーションプログラムで設定します。

構造体

XClassHint 構造体は、以下の様になります。

typedef struct {
char ∗res_name;
char ∗res_class;
} XClassHint;

res_nameメンバにはアプリケーションの名称が保持され、 res_classメンバにはアプリケーションクラスが保持されます。 なお、 この属性で設定する名称は、WM_NAMEで設定する名称と異なることもあります。 つまり、 WM_NAMEはタイトルバーに表示すべきものを指定し、 また一次情報（例えば、 エディター用バッファーにあるファイル名称）を保持出来ます。 さらに、WM_CLASSの一部として指定された名称は、 リソースデータベースからアプリケーション用リソースを検索するときに使用されるアプリケーションの正式名称です。

診断

BadAlloc サーバはリクエストされたリソースまたはサーバメモリの割り当てに失敗した。

BadWindow
Window引数の値が定義されているウィンドウ名称と一致しない。

関連事項

XAllocIconSize(3X11), XAllocSizeHints(3X11), XAllocWMHints(3X11), XFree(3X11), XSetCommand(3X11), XSetTransientForHint(3X11), XSetTextProperty(3X11), XSetWMClientMachine(3X11), XSetWMColormapWindows(3X11), XSetWMIconName(3X11), XSetWMName(3X11), XSetWMProperties(3X11), XSetWMProtocols(3X11), XStringListToTextProperty(3X11)
Xlib − C Language X Interface

NEWS-OS Release 4.1C