home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xtdatabase.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  7.3 KB  |  199 lines

  1.  
  2.  
  3.  
  4. XtDisplayInitialize(3Xt)   XT FUNCTIONS     XtDisplayInitialize(3Xt)
  5.  
  6.  
  7. NNAAMMEE
  8.        XtDisplayInitialize, XtOpenDisplay, XtDatabase, XtScreen-
  9.        Database, XtCloseDisplay - initialize, open, or close a
  10.        display
  11.  
  12. SSYYNNTTAAXX
  13.        void XtDisplayInitialize(_a_p_p___c_o_n_t_e_x_t, _d_i_s_p_l_a_y, _a_p_p_l_i_c_a_-
  14.        _t_i_o_n___n_a_m_e, _a_p_p_l_i_c_a_t_i_o_n___c_l_a_s_s,
  15.                   _o_p_t_i_o_n_s, _n_u_m___o_p_t_i_o_n_s, _a_r_g_c, _a_r_g_v)
  16.          XtAppContext _a_p_p___c_o_n_t_e_x_t;
  17.          Display *_d_i_s_p_l_a_y;
  18.          String _a_p_p_l_i_c_a_t_i_o_n___n_a_m_e;
  19.          String _a_p_p_l_i_c_a_t_i_o_n___c_l_a_s_s;
  20.          XrmOptionDescRec *_o_p_t_i_o_n_s;
  21.          Cardinal _n_u_m___o_p_t_i_o_n_s;
  22.          int *_a_r_g_c;
  23.          String *_a_r_g_v;
  24.  
  25.        Display *XtOpenDisplay(_a_p_p___c_o_n_t_e_x_t, _d_i_s_p_l_a_y___s_t_r_i_n_g, _a_p_p_l_i_-
  26.        _c_a_t_i_o_n___n_a_m_e, _a_p_p_l_i_c_a_t_i_o_n___c_l_a_s_s,
  27.                   _o_p_t_i_o_n_s, _n_u_m___o_p_t_i_o_n_s, _a_r_g_c, _a_r_g_v)
  28.           XtAppContext _a_p_p___c_o_n_t_e_x_t;
  29.           String _d_i_s_p_l_a_y___s_t_r_i_n_g;
  30.           String _a_p_p_l_i_c_a_t_i_o_n___n_a_m_e;
  31.           String _a_p_p_l_i_c_a_t_i_o_n___c_l_a_s_s;
  32.           XrmOptionDescRec *_o_p_t_i_o_n_s;
  33.           Cardinal _n_u_m___o_p_t_i_o_n_s;
  34.           int *_a_r_g_c;
  35.           String *_a_r_g_v;
  36.  
  37.        void XtCloseDisplay(_d_i_s_p_l_a_y)
  38.          Display *_d_i_s_p_l_a_y;
  39.  
  40.        XrmDatabase XtDatabase(_d_i_s_p_l_a_y)
  41.          Display *_d_i_s_p_l_a_y;
  42.  
  43.        XrmDatabase XtScreenDatabase(_s_c_r_e_e_n)
  44.          Screen* _s_c_r_e_e_n;
  45.  
  46. AARRGGUUMMEENNTTSS
  47.        _a_r_g_c     Specifies a pointer to the number of command
  48.          line parameters.
  49.  
  50.        _a_r_g_v     Specifies the command line parameters.
  51.  
  52.        _a_p_p___c_o_n_t_e_x_t
  53.          Specifies the application context.
  54.  
  55.        _a_p_p_l_i_c_a_t_i_o_n___c_l_a_s_s
  56.          Specifies the class name of this application,
  57.          which usually is the generic name for all
  58.          instances of this application.
  59.  
  60.  
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XtDisplayInitialize(3Xt)   XT FUNCTIONS     XtDisplayInitialize(3Xt)
  71.  
  72.  
  73.        _a_p_p_l_i_c_a_t_i_o_n___n_a_m_e
  74.          Specifies the name of the application instance.
  75.  
  76.        _d_i_s_p_l_a_y     Specifies the display.     Note that a display can
  77.          be in at most one application context.
  78.  
  79.        _n_u_m___o_p_t_i_o_n_s
  80.          Specifies the number of entries in the options
  81.          list.
  82.  
  83.        _o_p_t_i_o_n_s     Specifies how to parse the command line for any
  84.          application-specific resources.  The options
  85.          argument is passed as a parameter to
  86.          _X_r_m_P_a_r_s_e_C_o_m_m_a_n_d.  For further information, see
  87.          _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e.
  88.  
  89.        _s_c_r_e_e_n     Specifies the screen whose resource database is
  90.          to be returned.
  91.  
  92. DDEESSCCRRIIPPTTIIOONN
  93.        The _X_t_D_i_s_p_l_a_y_I_n_i_t_i_a_l_i_z_e function builds the resource
  94.        database, calls the Xlib _X_r_m_P_a_r_s_e_C_o_m_m_a_n_d function to parse
  95.        the command line, and performs other per display initial-
  96.        ization.     After _X_r_m_P_a_r_s_e_C_o_m_m_a_n_d has been called, argc and
  97.        argv contain only those parameters that were not in the
  98.        standard option table or in the table specified by the
  99.        options argument.  If the modified argc is not zero, most
  100.        applications simply print out the modified argv along with
  101.        a message listing the allowable options.     On UNIX-based
  102.        systems, the application name is usually the final compo-
  103.        nent of argv[0].     If the synchronize resource is _T_r_u_e for
  104.        the specified application, _X_t_D_i_s_p_l_a_y_I_n_i_t_i_a_l_i_z_e calls the
  105.        Xlib _X_S_y_n_c_h_r_o_n_i_z_e function to put Xlib into synchronous
  106.        mode for this display connection.  If the reverseVideo
  107.        resource is _T_r_u_e, the Intrinsics exchange _X_t_D_e_f_a_u_l_t_F_o_r_e_-
  108.        _g_r_o_u_n_d and _X_t_D_e_f_a_u_l_t_B_a_c_k_g_r_o_u_n_d for widgets created on this
  109.        display.     (See Section 9.6.1).
  110.  
  111.        The _X_t_O_p_e_n_D_i_s_p_l_a_y function calls _X_O_p_e_n_D_i_s_p_l_a_y the speci-
  112.        fied display name.  If display_string is NULL, _X_t_O_p_e_n_-
  113.        _D_i_s_p_l_a_y uses the current value of the -display option
  114.        specified in argv and if no display is specified in argv,
  115.        uses the user's default display (on UNIX-based systems,
  116.        this is the value of the DISPLAY environment variable).
  117.  
  118.        If this succeeds, it then calls _X_t_D_i_s_p_l_a_y_I_n_i_t_i_a_l_i_z_e and
  119.        pass it the opened display and the value of the -name
  120.        option specified in argv as the application name.  If no
  121.        name option is specified, it uses the application name
  122.        passed to _X_t_O_p_e_n_D_i_s_p_l_a_y.     If the application name is NULL,
  123.        it uses the last component of argv[0].  _X_t_O_p_e_n_D_i_s_p_l_a_y
  124.        returns the newly opened display or NULL if it failed.
  125.  
  126.        _X_t_O_p_e_n_D_i_s_p_l_a_y is provided as a convenience to the
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XtDisplayInitialize(3Xt)   XT FUNCTIONS     XtDisplayInitialize(3Xt)
  137.  
  138.  
  139.        application programmer.
  140.  
  141.        The _X_t_C_l_o_s_e_D_i_s_p_l_a_y function closes the specified display
  142.        as soon as it is safe to do so.    If called from within an
  143.        event dispatch (for example, a callback procedure),
  144.        _X_t_C_l_o_s_e_D_i_s_p_l_a_y does not close the display until the dis-
  145.        patch is complete.  Note that applications need only call
  146.        _X_t_C_l_o_s_e_D_i_s_p_l_a_y if they are to continue executing after
  147.        closing the display; otherwise, they should call _X_t_D_e_-
  148.        _s_t_r_o_y_A_p_p_l_i_c_a_t_i_o_n_C_o_n_t_e_x_t or just exit.
  149.  
  150.        The _X_t_D_a_t_a_b_a_s_e function returns the fully merged resource
  151.        database that was built by _X_t_D_i_s_p_l_a_y_I_n_i_t_i_a_l_i_z_e associated
  152.        with the display that was passed in.  If this display has
  153.        not been initialized by _X_t_D_i_s_p_l_a_y_I_n_i_t_i_a_l_i_z_e, the results
  154.        are not defined.
  155.  
  156.        The _X_t_S_c_r_e_e_n_D_a_t_a_b_a_s_e function returns the fully merged
  157.        resource database associated with the specified screen. If
  158.        the _s_c_r_e_e_n does not belong to a _D_i_s_p_l_a_y initilized by
  159.        _X_t_D_i_s_p_l_a_y_I_n_i_t_i_a_l_i_z_e, the results are undefined.
  160.  
  161. SSEEEE AALLSSOO
  162.        XtAppCreateShell(3Xt), XtCreateApplicationContext(3Xt)
  163.        _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
  164.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196. X Version 11           Release 6.1                3
  197.  
  198.  
  199.