home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xm / XmeConvertMerge.z / XmeConvertMerge
Encoding:
Text File  |  2002-10-03  |  8.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee - A toolkit function that merges data
  10.           converted during a transfer operation
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/Xm.h>
  14.           vvvvooooiiiidddd XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee(
  15.           XXXXttttPPPPooooiiiinnnntttteeeerrrr ddddaaaattttaaaa,
  16.           AAAAttttoooommmm ttttyyyyppppeeee,
  17.           iiiinnnntttt ffffoooorrrrmmmmaaaatttt,
  18.           uuuunnnnssssiiiiggggnnnneeeedddd lllloooonnnngggg lllleeeennnnggggtttthhhh,
  19.           XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt ****ccccaaaallllllll____ddddaaaattttaaaa);
  20.  
  21.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  22.           This page documents Motif 2.1.
  23.  
  24.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  25.           XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee merges data converted in the course of a
  26.           transfer operation.  The data to be merged is typically two
  27.           list of targets.  An XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedure in an
  28.           application may supply some elements of the list, and the
  29.           ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc trait method of a widget may supply others.
  30.           Therefore, the ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc trait method will need to call
  31.           XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee to merge the two target lists.
  32.  
  33.           XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee can only be called from an
  34.           XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedure or from a ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc trait
  35.           method.
  36.  
  37.           A ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc trait method usually calls XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeeewhen
  38.           an XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedure returns an
  39.           XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt structure containing a _s_t_a_t_u_s of
  40.           XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____MMMMEEEERRRRGGGGEEEE.
  41.  
  42.           XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee uses XXXXttttRRRReeeeaaaalllllllloooocccc to increase the allocated
  43.           storage for the _v_a_l_u_e member of the
  44.           XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuuccccttttpassed in the _c_a_l_l__d_a_t_a argument.  It
  45.           then appends _d_a_t_a to the data already present in the _v_a_l_u_e
  46.           member.  The _t_y_p_e and _f_o_r_m_a_t passed as arguments to
  47.           XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeeemust match the _t_y_p_e and _f_o_r_m_a_t fields passed
  48.           in the XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.
  49.  
  50.           _d_a_t_a      Specifies the data to be added to the _v_a_l_u_e member
  51.                     of the callback struct.
  52.  
  53.           _t_y_p_e      Indicates the type of _d_a_t_a.
  54.  
  55.           _f_o_r_m_a_t    Specifies how the call should interpret _d_a_t_a.  You
  56.                     must specify 8, 16, or 32. A value of 8888 implies
  57.                     that _d_a_t_ais an array of _c_h_a_r. A value of 11116666
  58.                     implies that _d_a_t_a is an array of _s_h_o_r_t. A value of
  59.                     33332222 implies that _d_a_t_a is an array of _l_o_n_g. It is
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee((((3333XXXX))))
  71.  
  72.  
  73.  
  74.                     possible that the specified number may not match
  75.                     the actual number of bits passed in _d_a_t_a. For
  76.                     example, a value of 32 may actually correspond to
  77.                     a 64-bit data structure on some machines.
  78.  
  79.           _l_e_n_g_t_h    Specifies the number of elements in _d_a_t_a, where
  80.                     each element has the number of bits specified by
  81.                     _f_o_r_m_a_t.
  82.  
  83.           _c_a_l_l__d_a_t_a Specifies a pointer to the XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt
  84.                     that is to be modified.
  85.  
  86.      RRRREEEELLLLAAAATTTTEEEEDDDD
  87.           XXXXmmmmQQQQTTTTttttrrrraaaannnnssssffffeeeerrrr(3), XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrDDDDoooonnnneeee(3), XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrVVVVaaaalllluuuueeee(3),
  88.           XXXXmmmmeeeeCCCClllliiiippppbbbbooooaaaarrrrddddSSSSiiiinnnnkkkk(3), XXXXmmmmeeeeCCCClllliiiippppbbbbooooaaaarrrrddddSSSSoooouuuurrrrcccceeee(3),
  89.           XXXXmmmmeeeeDDDDrrrraaaaggggSSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeDDDDrrrrooooppppSSSSiiiinnnnkkkk(3), XXXXmmmmeeeeGGGGeeeettttEEEEnnnnccccooooddddiiiinnnnggggAAAAttttoooommmm(3),
  90.           XXXXmmmmeeeePPPPrrrriiiimmmmaaaarrrryyyySSSSiiiinnnnkkkk(3), XXXXmmmmeeeePPPPrrrriiiimmmmaaaarrrryyyySSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSiiiinnnnkkkk(3),
  91.           XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyyTTTTrrrraaaannnnssssffffeeeerrrr(3),
  92.           XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt(3), XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddTTTTaaaarrrrggggeeeettttssss(3), and
  93.           XXXXmmmmeeeeTTTTrrrraaaannnnssssffffeeeerrrrAAAAddddddddDDDDoooonnnneeeePPPPrrrroooocccc(3).
  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.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.