名称

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 エラーがあります。 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.2.1R