関数

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;

引き数

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

countサイズリスト内の項目数を指定します。

count_returnサイズリスト内の項目数を返します。

size_listサイズリストへのポインタを指定します。

size_list_return
サイズリストへのポインタを返します。

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

解説

XAllocIconSize 関数は XIconSize 構造体へのポインタを割り当て、返します。 XIconSize 構造体の全てのフィールドがゼロに初期設定されていること。 メモリに必要な領域が不足する場合、 XAllocIconSize はナルを返します。 この構造体に割り当てるメモリを解放するには、 XFree を使います。 サポートされたアイコンサイズを設定する為にウインドウマネージャだけが、 XSetIconSizes 関数を使用出来ます。 XSetIconSizes で発生するエラーには、 BadAlloc および BadWindow エラーがあります。 The XGetIconSizes 関数は、 ウィンドウマネージャがアイコンサイズを設定してない場合ゼロを返し、 設定している場合ゼロ以外を返します。 XGetIconSizes は、 実行中のアプリケーションプログラムのウィンドウマネージャにもっとも適したアイコンサイズを必要とするアプリケーションに呼ばれます。 また、 サポートされたサイズのアイコンピックスマップまたはアイコンウィンドウをウィンドウマネージャに与える為、 XSetWMHints は設定されます。 size_list_returnに割り当てられたデータを解放する為, XFree を使います。 XGetIconSizes で発生するエラーには BadWindow エラーがあります。

属性

WM_ICON_SIZES
ウィンドウマネージャがサポートするアイコンサイズであれば、 ウィンドウマネージャによってルートウィンドウ上にこの属性が設定されます。 この属性のC言語のタイプは XIconSizeです。

構造体

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

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

width_incメンバおよびheight_incメンバは、 サポートするアイコンサイズ（最小から最大）の計算手続を定義します。

診断

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

BadWindow
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

NEWS-OSRelease 4.1C