X Version 11 (Release 6.1)

XtLanguageProc(X3xt)

XtLanguageProc -- set locale according to resource specification options

Synopsis

XtLanguageProc XtSetLanguageProc(app_context, proc, client_data)
    XtAppContext app_context;
    XtLanguageProc proc;
    XtPointer client_data;

Arguments

app_context: Specifies the application context in which the language procedure is to be used, or NULL.
client_data: Specified additional client data to be passed to the language procedure when it is called.
proc: Specifies the language procedure.

Description

Initially, no language procedure is set by the Intrinsics. To set the language procedure for use by XtDisplayInitialize use XtSetLanguageProc.

XtSetLanguageProc sets the language procedure that will be called from XtDisplayInitialize for all subsequent Displays initialized in the specified application context. If app_context is NULL, the specified language procedure is registered in all application contexts created by the calling process, including any future application contexts that may be created. If proc is NULL a default language procedure is registered. XtSetLanguageProc returns the previously registered language procedure. If a language procedure has not yet been registered, the return value is unspecified but if this return value is used in a subsequent call to XtSetLanguageProc, it will cause the default language procedure to be registered.

Resource databases are specified to be created in the current process locale. During display initialization prior to creating the per-screen resource database, the Intrinsics will call out to a specified application procedure to set the locale according to options found on the command line or in the per-display resource specifications.

The callout procedure provided by the application is of type XtLanguageProc:

   typedef String (*XtLanguageProc)(Display*, String, XtPointer);
         Display *display;
         String language;
         XtPointer client_data;

display: passes the display.
language: passes the initial language value obtained from the command line or server per-display resource specifications.
client_data: passes the additional client data specified in the call to XtSetLanguageProc.

References

XtDisplayInitialize(X3xt)

X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface