NAME
XtConvert, XtDirectConvert - invoke resource converters
SYNTAX
void XtConvert(Widget _w, String _f_r_o_m___t_y_p_e, XrmValuePtr _f_r_o_m,
String _t_o___t_y_p_e, XrmValuePtr _t_o___r_e_t_u_r_n);
void XtDirectConvert(XtConverter _c_o_n_v_e_r_t_e_r, XrmValuePtr _a_r_g_s,
Cardinal _n_u_m___a_r_g_s, XrmValuePtr _f_r_o_m, XrmValuePtr _t_o___r_e_t_u_r_n);
ARGUMENTS
the conversion (often NULL)
-
_a_r_g_s
Specifies the argument list that contains the additional arguments needed to perform .
-
-
_c_o_n_v_e_r_t_e_r
Specifies the conversion procedure that is to be called.
-
-
_f_r_o_m
Specifies the value to be converted.
-
-
_f_r_o_m___t_y_p_e
Specifies the source type.
-
-
_n_u_m___a_r_g_s
Specifies the number of additional arguments (often zero).
-
-
_t_o___t_y_p_e
Specifies the destination type.
-
-
_t_o___r_e_t_u_r_n
Returns the converted value.
-
-
_w
Specifies the widget to use for additional arguments (if any are needed).
-
DESCRIPTION
The
_X_t_C_o_n_v_e_r_t
function looks up the type converter registered to convert from_type
to to_type, computes any additional arguments needed, and then calls
_X_t_D_i_r_e_c_t_C_o_n_v_e_r_t.
_X_t_C_o_n_v_e_r_t
has been replaced by
_X_t_C_o_n_v_e_r_t_A_n_d_S_t_o_r_e.
The
_X_t_D_i_r_e_c_t_C_o_n_v_e_r_t
function looks in the converter cache to see if this conversion procedure
has been called with the specified arguments.
If so, it returns a descriptor for information stored in the cache;
otherwise, it calls the converter and enters the result in the cache.
Before calling the specified converter,
_X_t_D_i_r_e_c_t_C_o_n_v_e_r_t
sets the return value size to zero and the return value address to NULL.
To determine if the conversion was successful,
the client should check to_return.address for non-NULL.
_X_t_D_i_r_e_c_t_C_o_n_v_e_r_t
has been replaced by
_X_t_C_a_l_l_C_o_n_v_e_r_t_e_r.
SEE ALSO
XtAppAddConverter(3Xt),
XtStringConversionWarning(3Xt),
XtConvertAndStore(3Xt),
XtCallConverter(3Xt)
_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
_X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e