home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xtdisownselection.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  5.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XtOwnSelection(3Xt)       XT FUNCTIONS          XtOwnSelection(3Xt)
  5.  
  6.  
  7. NNAAMMEE
  8.        XtOwnSelection, XtOwnSelectionIncremental, XtDisown-
  9.        Selection - set selection owner
  10.  
  11. SSYYNNTTAAXX
  12.        Boolean XtOwnSelection(_w, _s_e_l_e_c_t_i_o_n, _t_i_m_e, _c_o_n_v_e_r_t___p_r_o_c,
  13.        _l_o_s_e___s_e_l_e_c_t_i_o_n, _d_o_n_e___p_r_o_c)
  14.          Widget _w;
  15.          Atom _s_e_l_e_c_t_i_o_n;
  16.          Time _t_i_m_e;
  17.          XtConvertSelectionProc _c_o_n_v_e_r_t___p_r_o_c;
  18.          XtLoseSelectionProc _l_o_s_e___s_e_l_e_c_t_i_o_n;
  19.          XtSelectionDoneProc _d_o_n_e___p_r_o_c;
  20.  
  21.        Boolean XtOwnSelectionIncremental(_w, _s_e_l_e_c_t_i_o_n, _t_i_m_e, _c_o_n_-
  22.        _v_e_r_t___c_a_l_l_b_a_c_k, _l_o_s_e___c_a_l_l_b_a_c_k, _d_o_n_e___c_a_l_l_b_a_c_k, _c_a_n_-
  23.        _c_e_l___c_a_l_l_b_a_c_k, _c_l_i_e_n_t___d_a_t_a)
  24.          Widget _w;
  25.          Atom _s_e_l_e_c_t_i_o_n;
  26.          Time _t_i_m_e;
  27.          XtConvertSelectionIncrProc _c_o_n_v_e_r_t___c_a_l_l_b_a_c_k;
  28.          XtLoseSelectionIncrProc _l_o_s_e___c_a_l_l_b_a_c_k;
  29.          XtSelectionDoneIncrProc _d_o_n_e___c_a_l_l_b_a_c_k;
  30.          XtCancelConvertSelectionProc _c_a_n_c_e_l___c_a_l_l_b_a_c_k;
  31.          XtPointer _c_l_i_e_n_t___d_a_t_a;
  32.  
  33.        void XtDisownSelection(_w, _s_e_l_e_c_t_i_o_n, _t_i_m_e)
  34.          Widget _w;
  35.          Atom _s_e_l_e_c_t_i_o_n;
  36.          Time _t_i_m_e;
  37.  
  38. AARRGGUUMMEENNTTSS
  39.        _c_o_n_v_e_r_t___p_r_o_c
  40.          Specifies the procedure that is to be called
  41.          whenever someone requests the current value of
  42.          the selection.
  43.  
  44.        _d_o_n_e___p_r_o_c Specifies the procedure that is called after the
  45.          requestor has received the selection or NULL if
  46.          the owner is not interested in being called
  47.          back.
  48.  
  49.        _l_o_s_e___s_e_l_e_c_t_i_o_n
  50.          Specifies the procedure that is to be called
  51.          whenever the widget has lost selection ownership
  52.          or NULL if the owner is not interested in being
  53.          called back.
  54.  
  55.        _s_e_l_e_c_t_i_o_n Specifies an atom that describes the type of the
  56.          selection (for example, _X_A___P_R_I_M_A_R_Y,
  57.          _X_A___S_E_C_O_N_D_A_R_Y, or _X_A___C_L_I_P_B_O_A_R_D).
  58.  
  59.        _t_i_m_e     Specifies the timestamp that indicates when the
  60.          selection ownership should commence or is to be
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XtOwnSelection(3Xt)       XT FUNCTIONS          XtOwnSelection(3Xt)
  71.  
  72.  
  73.          relinquished.
  74.  
  75.        _w     Specifies the widget that wishes to become the
  76.          owner or to relinquish ownership.
  77.  
  78. DDEESSCCRRIIPPTTIIOONN
  79.        The _X_t_O_w_n_S_e_l_e_c_t_i_o_n function informs the Intrinsics selec-
  80.        tion mechanism that a widget believes it owns a selection.
  81.        It returns _T_r_u_e if the widget has successfully become the
  82.        owner and _F_a_l_s_e otherwise.  The widget may fail to become
  83.        the owner if some other widget has asserted ownership at a
  84.        time later than this widget.  Note that widgets can lose
  85.        selection ownership either because someone else asserted
  86.        later ownership of the selection or because the widget
  87.        voluntarily gave up ownership of the selection.    Also note
  88.        that the lose_selection procedure is not called if the
  89.        widget fails to obtain selection ownership in the first
  90.        place.
  91.  
  92.        The _X_t_O_w_n_S_e_l_e_c_t_i_o_n_I_n_r_c_r_e_m_e_n_t_a_l procedure informs the
  93.        Intrinsics incremental selection mechanism that the speci-
  94.        fied widget wishes to own the selection. It returns _T_r_u_e
  95.        if the specified widget successfully becomes the selection
  96.        owner or _F_a_l_s_e otherwise. For more information about
  97.        _s_e_l_e_c_t_i_o_n, _t_a_r_g_e_t, and _t_i_m_e, see Section 2.6 of the _I_n_t_e_r_-
  98.        _C_l_i_e_n_t _C_o_m_m_u_n_i_c_a_t_i_o_n _C_o_n_v_e_n_t_i_o_n_s _M_a_n_u_a_l.
  99.  
  100.        A widget that becomes the selection owner using _X_t_O_w_n_-
  101.        _S_e_l_e_c_t_i_o_n_I_n_c_r_e_m_e_n_t_a_l may use _X_t_D_i_s_o_w_n_S_e_l_e_c_t_i_o_n to relin-
  102.        quish selection ownership.
  103.  
  104.        The _X_t_D_i_s_o_w_n_S_e_l_e_c_t_i_o_n function informs the Intrinsics
  105.        selection mechanism that the specified widget is to lose
  106.        ownership of the selection.  If the widget does not cur-
  107.        rently own the selection either because it lost the selec-
  108.        tion or because it never had the selection to begin with,
  109.        _X_t_D_i_s_o_w_n_S_e_l_e_c_t_i_o_n does nothing.
  110.  
  111.        After a widget has called _X_t_D_i_s_o_w_n_S_e_l_e_c_t_i_o_n, its convert
  112.        procedure is not called even if a request arrives later
  113.        with a timestamp during the period that this widget owned
  114.        the selection.  However, its done procedure will be called
  115.        if a conversion that started before the call to _X_t_D_i_s_o_w_n_-
  116.        _S_e_l_e_c_t_i_o_n finishes after the call to _X_t_D_i_s_o_w_n_S_e_l_e_c_t_i_o_n.
  117.  
  118. SSEEEE AALLSSOO
  119.        XtAppGetSelectionTimeout(3Xt), XtGetSelectionValue(3Xt)
  120.        _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
  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.