home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xallociconsize.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  4.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XAllocIconSize(3X11)      XLIB FUNCTIONS     XAllocIconSize(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XAllocIconSize, XSetIconSizes, XGetIconSizes, XIconSize -
  9.        allocate icon size structure and set or read a window's
  10.        WM_ICON_SIZES property
  11.  
  12. SSYYNNTTAAXX
  13.        XIconSize *XAllocIconSize()
  14.  
  15.        XSetIconSizes(_d_i_s_p_l_a_y, _w, _s_i_z_e___l_i_s_t, _c_o_u_n_t)
  16.          Display *_d_i_s_p_l_a_y;
  17.          Window _w;
  18.          XIconSize *_s_i_z_e___l_i_s_t;
  19.          int _c_o_u_n_t;
  20.  
  21.        Status XGetIconSizes(_d_i_s_p_l_a_y, _w, _s_i_z_e___l_i_s_t___r_e_t_u_r_n,
  22.        _c_o_u_n_t___r_e_t_u_r_n)
  23.          Display *_d_i_s_p_l_a_y;
  24.          Window _w;
  25.          XIconSize **_s_i_z_e___l_i_s_t___r_e_t_u_r_n;
  26.          int *_c_o_u_n_t___r_e_t_u_r_n;
  27.  
  28. AARRGGUUMMEENNTTSS
  29.        _d_i_s_p_l_a_y     Specifies the connection to the X server.
  30.  
  31.        _c_o_u_n_t     Specifies the number of items in the size list.
  32.  
  33.        _c_o_u_n_t___r_e_t_u_r_n
  34.          Returns the number of items in the size list.
  35.  
  36.        _s_i_z_e___l_i_s_t Specifies the size list.
  37.  
  38.        _s_i_z_e___l_i_s_t___r_e_t_u_r_n
  39.          Returns the size list.
  40.  
  41.        _w     Specifies the window.
  42.  
  43. DDEESSCCRRIIPPTTIIOONN
  44.        The _X_A_l_l_o_c_I_c_o_n_S_i_z_e function allocates and returns a
  45.        pointer to a _X_I_c_o_n_S_i_z_e structure.  Note that all fields in
  46.        the _X_I_c_o_n_S_i_z_e structure are initially set to zero.  If
  47.        insufficient memory is available, _X_A_l_l_o_c_I_c_o_n_S_i_z_e returns
  48.        NULL.  To free the memory allocated to this structure, use
  49.        _X_F_r_e_e.
  50.  
  51.        The _X_S_e_t_I_c_o_n_S_i_z_e_s function is used only by window managers
  52.        to set the supported icon sizes.
  53.  
  54.        _X_S_e_t_I_c_o_n_S_i_z_e_s can generate _B_a_d_A_l_l_o_c and _B_a_d_W_i_n_d_o_w errors.
  55.  
  56.        The _X_G_e_t_I_c_o_n_S_i_z_e_s function returns zero if a window man-
  57.        ager has not set icon sizes; otherwise, it return nonzero.
  58.        _X_G_e_t_I_c_o_n_S_i_z_e_s should be called by an application that
  59.        wants to find out what icon sizes would be most appreci-
  60.        ated by the window manager under which the application is
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XAllocIconSize(3X11)      XLIB FUNCTIONS     XAllocIconSize(3X11)
  71.  
  72.  
  73.        running.     The application should then use _X_S_e_t_W_M_H_i_n_t_s to
  74.        supply the window manager with an icon pixmap or window in
  75.        one of the supported sizes.  To free the data allocated in
  76.        size_list_return, use _X_F_r_e_e.
  77.  
  78.        _X_G_e_t_I_c_o_n_S_i_z_e_s can generate a _B_a_d_W_i_n_d_o_w error.
  79.  
  80. PPRROOPPEERRTTIIEESS
  81.        WM_ICON_SIZES
  82.          The window manager may set this property on the
  83.          root window to specify the icon sizes it sup-
  84.          ports.     The C type of this property is
  85.          _X_I_c_o_n_S_i_z_e.
  86.  
  87. SSTTRRUUCCTTUURREESS
  88.        The _X_I_c_o_n_S_i_z_e structure contains:
  89.  
  90.        typedef struct {
  91.         int min_width, min_height;
  92.         int max_width, max_height;
  93.         int width_inc, height_inc;
  94.        } XIconSize;
  95.  
  96.        The width_inc and height_inc members define an arithmetic
  97.        progression of sizes (minimum to maximum) that represent
  98.        the supported icon sizes.
  99.  
  100. DDIIAAGGNNOOSSTTIICCSS
  101.        _B_a_d_A_l_l_o_c     The server failed to allocate the requested
  102.          resource or server memory.
  103.  
  104.        _B_a_d_W_i_n_d_o_w A value for a Window argument does not name a
  105.          defined Window.
  106.  
  107. SSEEEE AALLSSOO
  108.        XAllocClassHint(3X11), XAllocSizeHints(3X11), XAl-
  109.        locWMHints(3X11), XFree(3X11), XSetCommand(3X11), XSet-
  110.        TransientForHint(3X11), XSetTextProperty(3X11), XSetWM-
  111.        ClientMachine(3X11), XSetWMColormapWindows(3X11), XSetWMI-
  112.        conName(3X11), XSetWMName(3X11), XSetWMProperties(3X11),
  113.        XSetWMProtocols(3X11), XStringListToTextProperty(3X11)
  114.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.