名称

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 関数は、指定したウィンドウのクラスヒントを設定します。 文字列が ホストポータブル文字コード (Host Portable Character Encoding) で ない場合は、結果は、インプリメンテーションにより異なります。 XSetClassHint で発生するエラーには、 BadAlloc および、 BadWindow エラーがあります。 XGetClassHint 関数は、指定したウィンドウのクラスヒントを 与えられた構造体のメンバに返します。 サーバの返したデータが ラテンポータブル文字コード (Latin Portable Character Encoding) の場合は、 返された文字列はホストポータブル文字コードとなります。 それ以外の場合は、結果はインプリメンテーションにより異なります。 成功した場合は、ゼロ以外のステータスを返します。 失敗した場合は、ゼロのステータスを返します。 文字列を伴って終了したときの 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.2.1R