XAllocIconSize(3X11)

名前
XAllocIconSize, XSetIconSizes, XGetIconSizes, XIconSize - アイコンサイズ構造体のアロケートとウィンドウの WM_ICON_SIZES プロパティの設定、取得

書式
XIconSize *XAllocIconSize()

XSetIconSizes(display, w, size_list, count)
      Display *display;
      Window w;
      XIconSize *size_list;
      int count;

Status XGetIconSizes(display, w, size_list_return, count_return)
      Display *display;
      Window w;
      XIconSize **size_list_return;
      int *count_return;

引き数

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

count
    サイズのリスト中の要素数を指定。

count_return
    サイズのリスト中の要素数が返される。

size_list
    サイズのリストを指定。

size_list_return
    サイズのリストが返される。

w   ウィンドウを指定。

説明
関数 は 構造体をアロケートし、それを指すポインタを返す。 の全てのフィールドはゼロで初期化される。 十分なメモリが確保できない場合、 は NULL を返す。 この構造体にアロケートされたメモリを解放するには、 を使用すること。

関数 はウィンドウマネージャだけが使う関数で、サポートしているアイコンのサイ ズをセットする。

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

関数 は、ウィンドウマネージャがアイコンのサイズをまだセットしていなければゼ ロを返し、すでにセットしていればゼロでない値を返す。 XGetIconSize がアプリケーションによって呼び出されるのは、そのアプリケー ションが(自分の親であるウィンドウマネージャにとって) 最も適切なアイコ ンサイズを知る必要があるような場合であろう。 そのアプリケーションは、サポートされているサイズからピクスマップやウィ ンドウを選び、それを XSetWMHints を用いて自分のウィンドウマネージャに 渡すことになるだろう。 size_list_return に対してアロケートされたデータを解放するには、 を使用すること。

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

プロパティ

WM_ICON_SIZES
    ウィンドウマネージャは、サポートしているアイコンのサイズを指定するため、 ルートウィンドウのこのプロパティをセットする。 このプロパティの C 言語における型は である。

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

typedef struct {
    int min_width, min_height;
    int max_width, max_height;
    int width_inc, height_inc; } XIconSize;

width_inc と height_inc メンバは、サポートされているアイコンのサイズを 表すサイズの増分(最小値から最大値まで)を定義する。

返り値

サーバが、要求されたリソースやサーバメモリのアロケートに失敗した。

引き数 Window の値が、定義されている Window を指していない。

関連項目
XAllocClassHint(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