XAllocClassHint(3X11)

名前
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;

引き数

display
    X サーバへの接続を指定する。

class_hints
    使用される 構造体を指定する。

class_hints_return
    構造体が返される。

w   ウィンドウを指定する。

説明
関数 は 構造体を割り当て、この構造体へのポインタを返す。 構造体の pointer フィールドは NULL で初期化される点に注意すること。 十分なメモリが確保できない場合、 は NULL を返す。 この構造体に対して割り当てられたメモリを解放するには、 を使用すること。

The 関数 は指定したウィンドウのクラスヒントを設定する。 文字列のエンコーディングがホストポータブル文字エンコーディングでない場 合、結果は実装依存である。

はエラー を起こすことがある。

関数 は、指定したウィンドウのクラスヒントを、与えられた構造体のメンバに返す。 サーバが返すデータのエンコーディングが Latin ポータブル文字エンコーディ ングならば、関数が返す文字列のエンコーディングはホストポータブル文字エ ンコーディングである。 そうでない場合の結果は実装依存である。 この関数は成功した場合には 0 でないステータスを返し、失敗した場合には ステータスとして 0 を返す。 文字列 res_name と res_class を使い終った後に解放するには、それぞれに 対して を行なうこと。

はエラー を起こすことがある。

プロパティ

WM_CLASS
    アプリケーションプログラムによってセットされ、ウィンドウマネージャやセッ ションマネージャがリソースデータベースからアプリケーションのリソースを 取得できるようにする。

構造体
構造体の内容を示す。

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

res_name メンバはアプリケーションの名前であり、 res_class はアプリケーションのクラスである。 このプロパティに設定されている名前は、WM_NAME として設定されている 名前とは異なる場合がある点に注意すること。 つまり、WM_NAME はタイトルバーに表示すべきものであり、したがって一時 的な情報を持つことがある(例えば、エディタのバッファの現在のファイル名)。 一方、WM_CLASS の一部として指定される名前は、リソースデータベースから アプリケーションのリソースを取り出す時に使われるアプリケーションの正 式な名前である。

返り値

要求されたリソースやサーバメモリの割り当てにサーバが失敗した。

引き数 Window の値が、定義されている 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