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