OpenWindows Developer's Guide: OLIT Code Generator Programmer's Guide
この本のみを検索
PDF 文書ファイルをダウンロードする

libgolit Library Function Reference

C

This appendix lists the libgolit library functions and their usage.

GolitNameToWidget()

Retrieves the widget id for the specified widget.
Widget
GolitNameToWidget (Widget                                 root,
                        String                            name);

Where:
rootThe widget in the widget tree where you would like to begin searching for the widget of the specified name. Normally, you can just use the widget that is passed as one of the callback parameters.
nameThe instance name of the widget for which you want to get an id.

GolitFetchLastWidgetID()

Retrieves the widget id for the last widget of the specified widget description pointer created.
Widget
GolitFetchLastWidgetID (GolitWidgetDescPtrwdp);

Where:
wdp......The widget description pointer. This is based on the name of an object that you set up in Devguide. See "Getting the Right Widget Instance Name" on page 63 for instructions on finding widget description pointer names.

GolitMergeArgLists()

This function merges args that you provide with the existing args in a widget description.
XtVarArgsList
GolitMergeArgLists (GolitWidgetDescPtr                    wdp,
                        ArgList                           override_args,
                        Cardinal                       num_args);

Where:
wdpThe widget description pointer. This is based on the name of an object that you set up in Devguide. See "Getting the Right Widget Instance Name" on page 63 for instructions on finding widget description pointer names.
override_argsa pointer to the list of args that you want to merge in.
num_args The number of args in ovveride_args.

GolitFetchWidget()

Instantiates the specified widget. It does not instantiate any children or popups.
Widget
GolitFetchWidget (String                                  name,
                        GolitWidgetDescPtr,               wdp,
                        Widget                            parent,
                        ArgList                           args,
                        Cardinal                          num_args,
                        XtPointer                         closure);

Where:
nameThe name of the widget that you want to fetch.
wdpThe widget description pointer. This is based on the name of an object that you set up in Devguide. See "Getting the Right Widget Instance Name" on page 63 for instructions on finding widget description pointer names.
parentThe id of the parent of the widget you want to fetch.
argsPointer to an Arg structure for the widget you want to fetch
num_argsThe number of arg in args.
closurePointer to an application data structure that you want to pass down the widget tree.

GolitFetchWidgetUnmanaged()

This function instantiates the specified widget, but does not add it to its parent's managed set. It does not instantiate any children or popups.
Widget
GolitFetchWidgetUnmanaged (String                         name,
                        GolitWidgetDescPtr,               wdp,
                        Widget                            parent,
                        ArgList                           args,
                        Cardinal                          num_args,
                        XtPointer                         closure);

Where:
name......The name of the widget that you want to fetch.
wdpThe widget description pointer. This is based on the name of an object that you set up in Devguide. See "Getting the Right Widget Instance Name" on page 63 for instructions on finding widget description pointer names.
parentThe id of the parent of the widget you want to fetch.
argsPointer to an Arg structure for the widget you want to fetch
num_argsThe number of arg in args.
closurePointer to an application data structure that you want to pass down the widget tree

GolitFetchChildren()

Instantiates the children of the specified widget. It does not instantiate popups.
Widget
GolitFetchChildren (String                                name,
                        GolitWidgetDescPtr,               wdp,
                        Widget                            parent,
                        ArgList                           args,
                        Cardinal                          num_args,
                        XtPointer                         closure);

Where:
nameThe name of the widget whose children you want to fetch.
wdpThe widget description pointer. This is based on the name of an object that you set up in Devguide. See "Getting the Right Widget Instance Name" on page 63 for instructions on finding widget description pointer names.
parentThe id of the parent of the widget whose children you want to fetch.
argsPointer to an Arg structure for the widget you want to fetch
num_argsThe number of arg in args.
closurePointer to an application data structure that you want to pass down the widget tree

GolitFetchChildrenUnmanaged()

Instantiates the children of the specified widget, but does not add them to the widget's managed set. It does not instantiate popups.
Widget
GolitFetchChildrenUnmanaged (String                       name,
                        GolitWidgetDescPtr,               wdp,
                        Widget                            parent,
                        ArgList                           args,
                        Cardinal                          num_args,
                        XtPointer                         closure);

Where:
nameThe name of the widget whose children you want to fetch.
wdpThe widget description pointer. This is based on the name of an object that you set up in Devguide. See "Getting the Right Widget Instance Name" on page 63 for instructions on finding widget description pointer names.
parentThe id of the parent of the widget whose children you want to fetch.
argsPointer to an Arg structure for the widget you want to fetch
num_argsThe number of arg in args.
closurePointer to an application data structure that you want to pass down the widget tree

GolitFetchPopups()

Instantiates the popups of the specified widget and the children of those popups.
Widget
GolitFetchPopups (String                                  name,
                        GolitWidgetDescPtr,               wdp,
                        Widget                            parent,
                        ArgList                           args,
                        Cardinal                          num_args,
                        XtPointer                         closure);

Where:
nameThe name of the widget whose popups you want to fetch.
wdpThe widget description pointer. This is based on the name of an object that you set up in Devguide. See "Getting the Right Widget Instance Name" on page 63 for instructions on finding widget description pointer names.
parentThe id of the parent of the widget whose popups you want to fetch.
argsPointer to an Arg structure for the widget you want to fetch
num_argsThe number of arg in args.
closurePointer to an application data structure that you want to pass down the widget tree

GolitFetchPopupsUnmanaged()

Instantiates the popups of the specified widget and the children of those popups. It does not add the popups to the widget's managed set.
Widget
GolitFetchPopupsUnmanaged (String                         name,
                        GolitWidgetDescPtr,               wdp,
                        Widget                            parent,

ArgList                           args,
Cardinal                          num_args,
XtPointer                         closure);

Where:
nameThe name of the widget whose popups you want to fetch.
wdpThe widget description pointer. This is based on the name of an object that you set up in Devguide. See "Getting the Right Widget Instance Name" on page 63 for instructions on finding widget description pointer names.
parentThe id of the parent of the widget whose popups you want to fetch.
argsPointer to an Arg structure for the widget you want to fetch
num_args            The number of arg in args.

closure

GolitFetchWidgetHier()

Instantiates the specified widget, its popups, and its children
Widget
GolitFetchWidgetHier (String                              name,
                        GolitWidgetDescPtr,               wdp,
                        Widget                            parent,
                        ArgList                           args,
                        Cardinal                          num_args,
                        XtPointer                         closure);

Where:
name......The name of the widget whose hierarchy you want to fetch.
wdpThe widget description pointer. This is based on the name of an object that you set up in Devguide. See "Getting the Right Widget Instance Name" on page 63 for instructions on finding widget description pointer names.
parentThe id of the parent of the widget whose hierarchy you want to fetch.
argsPointer to an Arg structure for the widget you want to fetch
num_argsThe number of arg in args.
closurePointer to an application data structure that you want to pass down the widget tree

GolitFetchWidgetHierUnmanaged()

Instantiates the specified widget, its popups, and its children but does not add the widget to its parent's managed set.
Widget
GolitFetchWidgetHierUnmanaged (String                     name,
                        GolitWidgetDescPtr,               wdp,
                        Widget                            parent,
                        ArgList                           args,
                        Cardinal                          num_args,
                        XtPointer                         closure);

Where:
nameThe name of the widget whose hierarchy you want to fetch.
wdpThe widget description pointer. This is based on the name of an object that you set up in Devguide. See "Getting the Right Widget Instance Name" on page 63 for instructions on finding widget description pointer names.
parentThe id of the parent of the widget whose hierarchy you want to fetch.
argsPointer to an Arg structure for the widget you want to fetch
num_argsThe number of arg in args.
closurePointer to an application data structure that you want to pass down the widget tree

GolitFetchShellHier()

Instantiates a shell widget and all its children. Use this only for base windows.
Widget
GolitFetchShellHier (String                               app_name,
                        String                            app_class,
                        GolitWidgetDescPtr,               wdp,
                        Display                           *dpy,
                        ArgList                           args,
                        Cardinal                          num_args,
                        XtPointer                         closure);

Where:
app_name            The base window's name.

app_class           The application's class.

wdpThe widget description pointer. This is based on the name of an object that you set up in Devguide. See "Getting the Right Widget Instance Name" on page 63 for instructions on finding widget description pointer names.
dpyDisplay
argsResources.
num_argsNumber of args.
closurePointer to an application data structure that you want to pass down the widget tree