home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xtallocategc.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  3.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XtAllocateGC(3Xt)       XT FUNCTIONS        XtAllocateGC(3Xt)
  5.  
  6.  
  7. NNAAMMEE
  8.        XtAllocateGC - obtain a sharable GC with modifiable fields
  9.  
  10. SSYYNNTTAAXX
  11.        GC XtAllocateGC(_w, _d_e_p_t_h, _v_a_l_u_e___m_a_s_k, _v_a_l_u_e_s,
  12.        _d_y_n_a_m_i_c___m_a_s_k, _u_n_u_s_e_d___m_a_s_k)
  13.          Widget _w;
  14.          Cardinal _d_e_p_t_h;
  15.          XtGCMask _v_a_l_u_e___m_a_s_k;
  16.          XGCValues *_v_a_l_u_e_s;
  17.          XtGCMask _d_y_n_a_m_i_c___m_a_s_k;
  18.          XtGCMask _u_n_u_s_e_d___m_a_s_k;
  19.  
  20. AARRGGUUMMEENNTTSS
  21.        _v_a_l_u_e_s     Specifies the actual values for this GC.
  22.  
  23.        _v_a_l_u_e___m_a_s_k
  24.          Specifies which fields of the values are speci-
  25.          fied.
  26.  
  27.        _w     Specifies the widget.
  28.  
  29.        _d_e_p_t_h     Specifies the depth for which the returned GC is
  30.          valid, or 0.
  31.  
  32.        _d_y_n_a_m_i_c___m_a_s_k
  33.          Specifies the fields of the GC that will be mod-
  34.          ified by the caller.
  35.  
  36.        _u_n_u_s_e_d___m_a_s_k
  37.          Specifies the fields of the GC that will not be
  38.          needed by the caller.
  39.  
  40. DDEESSCCRRIIPPTTIIOONN
  41.        The _X_t_A_l_l_o_c_a_t_e_G_C function returns a sharable GC that may
  42.        be modified by the client.  The _s_c_r_e_e_n field of the speci-
  43.        fied widget or of the nearest widget ancestor of the spec-
  44.        ified object and the specified _d_e_p_t_h argument supply the
  45.        root and drawable depths for which the GC is to be valid.
  46.        If _d_e_p_t_h is zero the depth is taken from the _d_e_p_t_h field
  47.        of the specified widget or of the nearest widget ancestor
  48.        of the specified object.
  49.  
  50.        The _v_a_l_u_e___m_a_s_k argument specifies the fields of the GC
  51.        that will be initialized with the respective members of
  52.        the _v_a_l_u_e_s structure.  The _d_y_n_a_m_i_c___m_a_s_k argument specifies
  53.        fields that the caller intends to modify during program
  54.        execution. The caller must ensure that the corresponding
  55.        GC field is sdet prior to each use of the GC. The
  56.        _u_n_u_s_e_d___m_a_s_k argument specifies fields of the GC that are
  57.        of no interest to the caller. The caller may make no
  58.        assumptions about the contents of any fields specified in
  59.        _u_n_u_s_e_d___m_a_s_k. The caller may assume that at all times all
  60.        fields not specified in either _d_y_n_a_m_i_c___m_a_s_k or _u_n_u_s_e_d___m_a_s_k
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XtAllocateGC(3Xt)       XT FUNCTIONS        XtAllocateGC(3Xt)
  71.  
  72.  
  73.        have their default value if not specified in _v_a_l_u_e___m_a_s_k or
  74.        the value specified by _v_a_l_u_e_s.  If a field is specified in
  75.        both _v_a_l_u_e___m_a_s_k and _d_y_n_a_m_i_c___m_a_s_k, the effect is as if it
  76.        were specified only in _d_y_n_a_m_i_c___m_a_s_k and then immediately
  77.        set to the value in _v_a_l_u_e_s. If a field is set in
  78.        _u_n_u_s_e_d___m_a_s_k and also in either _v_a_l_u_e___m_a_s_k or _d_y_n_a_m_i_c___m_a_s_k,
  79.        the specification in _u_n_u_s_e_d___m_a_s_k is ignored.
  80.  
  81.        _X_t_A_l_l_o_c_a_t_e_G_C tries to minimize the number of unique GCs
  82.        created by comparing the arguments with those of previous
  83.        calls and returning an existing GC when there are no con-
  84.        flicts.    _X_t_A_l_l_o_c_a_t_e_G_C may modify and return an existing GC
  85.        if it was allocated with a nonzero _u_n_u_s_e_d___m_a_s_k.
  86.  
  87. SSEEEE AALLSSOO
  88.        _X_t_G_e_t_G_C
  89.        _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s _- _C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e
  90.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  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.