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 / XmeNamedSource.z / XmeNamedSource
Encoding:
Text File  |  2002-10-03  |  9.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmeeeeNNNNaaaammmmeeeeddddSSSSoooouuuurrrrcccceeee((((3333XXXX))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV        XXXXmmmmeeeeNNNNaaaammmmeeeeddddSSSSoooouuuurrrrcccceeee((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmeeeeNNNNaaaammmmeeeeddddSSSSoooouuuurrrrcccceeee - A toolkit function that takes ownership of
  10.           a named selection
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/TransferP.h>
  14.           BBBBoooooooolllleeeeaaaannnn XXXXmmmmeeeeNNNNaaaammmmeeeeddddSSSSoooouuuurrrrcccceeee(
  15.           WWWWiiiiddddggggeeeetttt wwwwiiiiddddggggeeeetttt,
  16.           AAAAttttoooommmm nnnnaaaammmmeeeedddd____sssseeeelllleeeeccccttttiiiioooonnnn,
  17.           TTTTiiiimmmmeeee ttttiiiimmmmeeee);
  18.  
  19.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  20.           This page documents Motif 2.1.
  21.  
  22.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.           XXXXmmmmeeeeNNNNaaaammmmeeeeddddSSSSoooouuuurrrrcccceeee takes ownership of the specified selection.
  24.  
  25.           This routine establishes a function that is called when the
  26.           widget is asked to convert the selection named
  27.           _n_a_m_e_d__s_e_l_e_c_t_i_o_n.  That function makes the following sequence
  28.           of calls:
  29.  
  30.              1. Calls the application's XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures,
  31.                 if any.  XXXXmmmmeeeeNNNNaaaammmmeeeeddddSSSSoooouuuurrrrcccceeee passes an
  32.                 XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt(with the _s_e_l_e_c_t_i_o_n member set
  33.                 to _n_a_m_e_d__s_e_l_e_c_t_i_o_n) to each of these
  34.                 XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures.
  35.  
  36.              2. Calls the source widget's ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc trait method;
  37.                 ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc is one of the trait methods of the
  38.                 _X_m_Q_T_t_r_a_n_s_f_e_rtrait. However, if any XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk
  39.                 procedure returns XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____DDDDOOOONNNNEEEE or XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____RRRREEEEFFFFUUUUSSSSEEEE,
  40.                 then XXXXmmmmeeeeNNNNaaaammmmeeeeddddSSSSoooouuuurrrrcccceeee will not call ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc.
  41.  
  42.           This routine also establishes a function that is called when
  43.           the widget loses the selection.  That function makes the
  44.           following sequence of calls:
  45.  
  46.              1. Calls the application's XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures,
  47.                 if any.  XXXXmmmmeeeeNNNNaaaammmmeeeeddddSSSSoooouuuurrrrcccceeee passes an
  48.                 XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuuccccttttto each of these
  49.                 XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures.  XXXXmmmmeeeeNNNNaaaammmmeeeeddddSSSSoooouuuurrrrcccceeee
  50.                 initializes the XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuuccccttttas follows:
  51.  
  52.                    +o  Sets the _s_e_l_e_c_t_i_o_n member to the _n_a_m_e_d__s_e_l_e_c_t_i_o_n
  53.                       argument
  54.  
  55.                    +o  Sets the _t_a_r_g_e_t member to ____MMMMOOOOTTTTIIIIFFFF____LLLLOOOOSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTTIIIIOOOONNNN
  56.  
  57.              2. Calls the source widget's ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc trait method.
  58.                 However, if any XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedure returns
  59.                 XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____DDDDOOOONNNNEEEE or XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____RRRREEEEFFFFUUUUSSSSEEEE, then
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmeeeeNNNNaaaammmmeeeeddddSSSSoooouuuurrrrcccceeee((((3333XXXX))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV        XXXXmmmmeeeeNNNNaaaammmmeeeeddddSSSSoooouuuurrrrcccceeee((((3333XXXX))))
  71.  
  72.  
  73.  
  74.                 XXXXmmmmeeeeNNNNaaaammmmeeeeddddSSSSoooouuuurrrrcccceeee will not call ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc.
  75.  
  76.           _w_i_d_g_e_t    Specifies the widget that is to take ownership of
  77.                     the selection.
  78.  
  79.           _n_a_m_e_d__s_e_l_e_c_t_i_o_n
  80.                     Specifies the AAAAttttoooommmm that names the selection to
  81.                     own.
  82.  
  83.           _t_i_m_e      Specifies the time of the transfer.  This is
  84.                     usually the timestamp from the event passed to an
  85.                     action routine.  You should call
  86.                     _X_t_L_a_s_t_T_i_m_e_S_t_a_m_p_P_r_o_c_e_s_s_e_d to generate the
  87.                     _t_i_m_evalue.  If you set _t_i_m_e to CCCCuuuurrrrrrrreeeennnnttttTTTTiiiimmmmeeee or 0,
  88.                     UTM will automatically change the call to
  89.                     _X_t_L_a_s_t_T_i_m_e_S_t_a_m_p_P_r_o_c_e_s_s_e_d.
  90.  
  91.      RRRREEEETTTTUUUURRRRNNNN
  92.           This function returns False if the widget cannot take
  93.           ownership of the specified selection.  Otherwise, it returns
  94.           True.
  95.  
  96.      RRRREEEELLLLAAAATTTTEEEEDDDD
  97.           XXXXmmmmQQQQTTTTttttrrrraaaannnnssssffffeeeerrrr(3), XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrDDDDoooonnnneeee(3), XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrVVVVaaaalllluuuueeee(3),
  98.           XXXXmmmmeeeeCCCClllliiiippppbbbbooooaaaarrrrddddSSSSiiiinnnnkkkk(3), XXXXmmmmeeeeCCCClllliiiippppbbbbooooaaaarrrrddddSSSSoooouuuurrrrcccceeee(3),
  99.           XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee(3), XXXXmmmmeeeeDDDDrrrraaaaggggSSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeDDDDrrrrooooppppSSSSiiiinnnnkkkk(3),
  100.           XXXXmmmmeeeeGGGGeeeettttEEEEnnnnccccooooddddiiiinnnnggggAAAAttttoooommmm(3), XXXXmmmmeeeePPPPrrrriiiimmmmaaaarrrryyyySSSSiiiinnnnkkkk(3), XXXXmmmmeeeeNNNNaaaammmmeeeeddddSSSSiiiinnnnkkkk(3),
  101.           XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSiiiinnnnkkkk(3), XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSoooouuuurrrrcccceeee(3),
  102.           XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyyTTTTrrrraaaannnnssssffffeeeerrrr(3), XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt(3),
  103.           XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddTTTTaaaarrrrggggeeeettttssss(3), and XXXXmmmmeeeeTTTTrrrraaaannnnssssffffeeeerrrrAAAAddddddddDDDDoooonnnneeeePPPPrrrroooocccc(3).
  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.