名称

XSetIconName, XGetIconName - アイコン名を設定し、獲得する

形式

XSetIconName(display, w, icon_name)
      Display ∗display;
      Window w;
      char ∗icon_name; Status XGetIconName(display, w, icon_name_return)
      Display ∗display;
      Window w;
      char ∗∗icon_name_return;

引数

displayX サーバへのコネクションを指定します。

icon_nameアイコン名を指定します。 これはナルで終わる文字列でなければなりません。

icon_name_return
ウィンドウのアイコン名を指すポインタを返します。 これはナルで終わる文字列です。

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

解説

XSetIconName 関数は、ウィンドウのアイコンに表示する名前を設定します。 .PN XSetIconName は、 BadAlloc および BadWindow エラーを生じることがあります。 XGetIconName 関数は、指定されたウィンドウのアイコンに表示する名前を返します。 成功した場合は、 0 でない値が返され、それとは逆に、アイコン名がウィン ドウに何も設定されていない場合は、0 が返されます。 ウィンドウに名前を割り当てたことがない場合は、 XGetIconName が、 icon_name_return を null へ設定します。 終了したときは、クライアントは、 XFree を使用してアイコン名の文字列を解放しなければなりません。 .PN XGetIconName は、 BadWindow エラーを生じることがあります。

特性

WM_ICON_NAME

診断

BadAlloc サーバが要求されたリソース、または、サーバメモリの割当てに失敗した。

BadWindow
Window 引数の値が定義された Window を指さない。

関連事項

XSetClassHint(3X11), XSetCommand(3X11), XSetIconSizeHints(3X11), XSetNormalHints(3X11), XSetSizeHints(3X11), XSetStandardProperties(3X11), XSetTransientForHint(3X11), XSetWMHints(3X11), XSetZoomHints(3X11), XStoreName(3X11)
Xlib − C Language X Interface

NEWS-OSRelease 3.3