X11: ICCCM (1) - テキスト

クライアントは、ICCCM が定義しているプロパティを、あらかじめウィンドウにセットしておくことで、自身が望むウィンドウ動作を、ウィンドウマネージャに通知することができます。
設定されていないプロパティに関しては、ウィンドウマネージャによって、デフォルトの値が使用されます。

この場合のプロパティは、一度の XChangeProperty() で、mode = PropModeReplace によってセットする必要があります。
大きなサイズのデータを除き、複数回に分割してデータを送るようなことは、基本的にしないでください。
(ウィンドウマネージャ側で、PropertyNotify イベントにより、プロパティの変更を監視している場合があるので、一度のプロパティ変更で、すべてのデータを取得できるようにする必要があります)

typedef struct {
    unsigned char *value; //プロパティデータ
    Atom encoding; //エンコーディング (プロパティのタイプ)
    int format;    //8,16,32
    unsigned long nitems; //データの個数
} XTextProperty;

TEXT タイプ用のプロパティデータです。
解放時は、value ポインタを XFree() で解放する必要があります。

複数の文字列がある場合は、ヌル区切りになります。
エンコーディングによって、実際のデータは異なります。

int XmbTextListToTextProperty(Display *display, char **list, int count,
    XICCEncodingStyle style, XTextProperty *text_prop_return);

int XwcTextListToTextProperty(Display *display, wchar_t **list, int count,
    XICCEncodingStyle style, XTextProperty *text_prop_return);

//XFree86 拡張
int Xutf8TextListToTextProperty(Display *display, char **list, int count,
    XICCEncodingStyle style, XTextProperty *text_prop_return);

typedef enum {
    XStringStyle,         // STRING (ラテン文字)
    XCompoundTextStyle,   // COMPOUND_TEXT (マルチエンコーディング)
    XTextStyle,           // TEXT (現在のロケール)
    XStdICCTextStyle,     // STRING。変換できなければ COMPOUND_TEXT
    XUTF8StringStyle      // UTF8_STRING (XFree86 による拡張)
} XICCEncodingStyle;

#define XNoMemory           -1
#define XLocaleNotSupported -2
#define XConverterNotFound  -3

Xmb は現在のロケールでのマルチバイト文字列のリストから、Xwc はワイド文字列のリストから、プロパティを設定するための XTextProperty 構造体にデータをセットします。
※Xmb の場合は、あらかじめ C ロケールをセットしている必要があります。

Xutf8 は、XFree86 による拡張で、UTF-8 文字列から変換します。X.Org の実装でも使用できますが、他の実装で使えるかはわかりません。

list	文字列のリスト (char * の配列)
count	文字列の数
style	変換後のエンコーディングタイプ
戻り値	Success で成功。 XNoMemory でメモリが足りない。 XLocaleNotSupported で、現在のロケールが X でサポートされていない。

基本的に、通常のラテン文字しか含まれていなければ XStringStyle、日本語などを含む場合は、マルチエンコーディングに対応している XCompoundTextStyle、自動で判断させたい場合は XStdICCTextStyle を指定します。

void XSetTextProperty(Display *display, Window w, XTextProperty *text_prop, Atom property);

XTextProperty 構造体の値を元に、ウィンドウのプロパティにデータをセットします。

タイトルバーなどに表示される、アプリケーションの名前。

void XSetWMName(Display *display, Window w, XTextProperty *text_prop);
void XStoreName(Display *display, Window w, char *window_name);

アイコン化されている時に表示される、アプリケーションの名前。
最小化している時に表示されるとは限りません。

void XSetWMIconName(Display *display, Window w, XTextProperty *text_prop);
void XSetIconName(Display *display, Window w, char *icon_name);

サーバーを実行しているマシンから見た時の、クライアントを実行しているマシンの名前。
Unix 系であれば、gethostname() で取得できるホスト名を指定します。

void XSetWMClientMachine(Display *display, Window w, XTextProperty *text_prop);

WM_CLASS プロパティには、ヌルで終わる２つの文字列を設定します。

XSetClassHint(Display *display, Window w, XClassHint *class_hints);

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

１つ目がアプリケーションのリソース名、２つ目がアプリケーションのクラス名です。

リソース名は、X リソースから値を取得する時に使われます。

基本的には、どちらもアプリケーション名を設定すれば問題ありません。