home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / X11 / XSetSelectionOwner.z / XSetSelectionOwner
Encoding:
Text File  |  1998-10-30  |  6.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXSSSSeeeettttSSSSeeeelllleeeeccccttttiiiioooonnnnOOOOwwwwnnnneeeerrrr((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXSSSSeeeettttSSSSeeeelllleeeeccccttttiiiioooonnnnOOOOwwwwnnnneeeerrrr((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XSetSelectionOwner, XGetSelectionOwner, XConvertSelection -
  10.           manipulate window selection
  11.  
  12.      SSSSYYYYNNNNTTTTAAAAXXXX
  13.           XSetSelectionOwner(_d_i_s_p_l_a_y, _s_e_l_e_c_t_i_o_n, _o_w_n_e_r, _t_i_m_e)
  14.                 Display *_d_i_s_p_l_a_y;
  15.                 Atom _s_e_l_e_c_t_i_o_n;
  16.                 Window _o_w_n_e_r;
  17.                 Time _t_i_m_e;
  18.  
  19.           Window XGetSelectionOwner(_d_i_s_p_l_a_y, _s_e_l_e_c_t_i_o_n)
  20.                 Display *_d_i_s_p_l_a_y;
  21.                 Atom _s_e_l_e_c_t_i_o_n;
  22.  
  23.           XConvertSelection(_d_i_s_p_l_a_y, _s_e_l_e_c_t_i_o_n, _t_a_r_g_e_t, _p_r_o_p_e_r_t_y,
  24.           _r_e_q_u_e_s_t_o_r, _t_i_m_e)
  25.                 Display *_d_i_s_p_l_a_y;
  26.                 Atom _s_e_l_e_c_t_i_o_n, _t_a_r_g_e_t;
  27.                 Atom _p_r_o_p_e_r_t_y;
  28.                 Window _r_e_q_u_e_s_t_o_r;
  29.                 Time _t_i_m_e;
  30.  
  31.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  32.           _d_i_s_p_l_a_y   Specifies the connection to the X server.
  33.  
  34.           _o_w_n_e_r     Specifies the owner of the specified selection
  35.                     atom.  You can pass a window or _N_o_n_e.
  36.  
  37.           _p_r_o_p_e_r_t_y  Specifies the property name.  You also can pass
  38.                     _N_o_n_e.
  39.  
  40.           _r_e_q_u_e_s_t_o_r Specifies the requestor.
  41.  
  42.           _s_e_l_e_c_t_i_o_n Specifies the selection atom.
  43.  
  44.           _t_a_r_g_e_t    Specifies the target atom.
  45.  
  46.           _t_i_m_e      Specifies the time.  You can pass either a
  47.                     timestamp or _C_u_r_r_e_n_t_T_i_m_e.
  48.  
  49.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  50.           The _X_S_e_t_S_e_l_e_c_t_i_o_n_O_w_n_e_r function changes the owner and last-
  51.           change time for the specified selection and has no effect if
  52.           the specified time is earlier than the current last-change
  53.           time of the specified selection or is later than the current
  54.           X server time.  Otherwise, the last-change time is set to
  55.           the specified time, with _C_u_r_r_e_n_t_T_i_m_e replaced by the current
  56.           server time.  If the owner window is specified as _N_o_n_e, then
  57.           the owner of the selection becomes _N_o_n_e (that is, no owner).
  58.           Otherwise, the owner of the selection becomes the client
  59.           executing the request.
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXSSSSeeeettttSSSSeeeelllleeeeccccttttiiiioooonnnnOOOOwwwwnnnneeeerrrr((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXSSSSeeeettttSSSSeeeelllleeeeccccttttiiiioooonnnnOOOOwwwwnnnneeeerrrr((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.           If the new owner (whether a client or _N_o_n_e) is not the same
  75.           as the current owner of the selection and the current owner
  76.           is not _N_o_n_e, the current owner is sent a _S_e_l_e_c_t_i_o_n_C_l_e_a_r
  77.           event.  If the client that is the owner of a selection is
  78.           later terminated (that is, its connection is closed) or if
  79.           the owner window it has specified in the request is later
  80.           destroyed, the owner of the selection automatically reverts
  81.           to _N_o_n_e, but the last-change time is not affected.  The
  82.           selection atom is uninterpreted by the X server.
  83.           _X_G_e_t_S_e_l_e_c_t_i_o_n_O_w_n_e_r returns the owner window, which is
  84.           reported in _S_e_l_e_c_t_i_o_n_R_e_q_u_e_s_t and _S_e_l_e_c_t_i_o_n_C_l_e_a_r events.
  85.           Selections are global to the X server.
  86.  
  87.           _X_S_e_t_S_e_l_e_c_t_i_o_n_O_w_n_e_r can generate _B_a_d_A_t_o_m and _B_a_d_W_i_n_d_o_w
  88.           errors.
  89.  
  90.           The _X_G_e_t_S_e_l_e_c_t_i_o_n_O_w_n_e_r function returns the window ID
  91.           associated with the window that currently owns the specified
  92.           selection.  If no selection was specified, the function
  93.           returns the constant _N_o_n_e.  If _N_o_n_e is returned, there is no
  94.           owner for the selection.
  95.  
  96.           _X_G_e_t_S_e_l_e_c_t_i_o_n_O_w_n_e_r can generate a _B_a_d_A_t_o_m error.
  97.  
  98.           _X_C_o_n_v_e_r_t_S_e_l_e_c_t_i_o_n requests that the specified selection be
  99.           converted to the specified target type:
  100.  
  101.           +o    If the specified selection has an owner, the X server
  102.                sends a _S_e_l_e_c_t_i_o_n_R_e_q_u_e_s_t event to that owner.
  103.  
  104.           +o    If no owner for the specified selection exists, the X
  105.                server generates a _S_e_l_e_c_t_i_o_n_N_o_t_i_f_y event to the
  106.                requestor with property _N_o_n_e.
  107.  
  108.           The arguments are passed on unchanged in either of the
  109.           events.  There are two predefined selection atoms: PRIMARY
  110.           and SECONDARY.
  111.  
  112.           _X_C_o_n_v_e_r_t_S_e_l_e_c_t_i_o_n can generate _B_a_d_A_t_o_m and _B_a_d_W_i_n_d_o_w errors.
  113.  
  114.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  115.           _B_a_d_A_t_o_m   A value for an Atom argument does not name a
  116.                     defined Atom.
  117.  
  118.           _B_a_d_W_i_n_d_o_w A value for a Window argument does not name a
  119.                     defined Window.
  120.  
  121.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  122.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.