Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ XSeIcSH(XS) — OpenDesktop Software Development System 1.0.0d

Media Vault

Software Library

Restoration Projects

Artifacts Sought


     X Version 11 (1 September 1988)        XSetIconSizeHints(XS)



     NAME
          XSetIconSizes, XGetIconSizes - set or get icon size hints


     SYNTAX
          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;


     ARGUMENTS
          display   Specifies the connection to the X server.

          count     Specifies the number of items in the size list.

          count_return
                    Returns the number of items in the size list.

          size_list Specifies a pointer to the size list.

          size_list_return
                    Returns a pointer to the size list.

          w         Specifies the window.


     DESCRIPTION
          The XSetIconSizes function is used only by window managers
          to set the supported icon sizes.

          XSetIconSizes can generate BadAlloc and BadWindow errors.

          The XGetIconSizes function returns zero if a window manager
          has not set icon sizes or nonzero otherwise.  XGetIconSizes
          should be called by an application that wants to find out
          what icon sizes would be most appreciated by the window
          manager under which the application is running.  The
          application should then use XSetWMHints to supply the window
          manager with an icon pixmap or window in one of the
          supported sizes.  To free the data allocated in
          size_list_return, use XFree.

          XGetIconSizes can generate a BadWindow error.


     PROPERTY
          WM_ICON_SIZE


     DIAGNOSTICS
          BadAlloc  The server failed to allocate the requested
                    resource or server memory.

          BadWindow A value for a Window argument does not name a
                    defined Window.


     SEE ALSO
          XSetClassHint(XS), XSetCommand(XS), XSetIconName(XS),
          XSetNormalHints(XS), XSetSizeHints(XS),
          XSetStandardProperties(XS), XSetTransientForHint(XS),
          XSetWMHints(XS), XSetZoomHints(XS), XStoreName(XS)
          Xlib - C Language X Interface


     (printed 2/12/90) (1 September 1988)   XSetIconSizeHints(XS)

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026