FreeBSD Manual Pages
XmtGetApplicationValues(3) Library Functions Manual XmtGetApplicationValues(3) NAME XmtGetApplicationValues(), XmtSetApplicationValues() - query and set appli- cation resources by name. SYNOPSIS #include <Xmt/AppRes.h> void XmtGetApplicationValues(Widget w, ArgList args, Cardinal num_args) void XmtSetApplicationValues(Widget w, ArgList args, Cardinal num_args) ARGUMENTS INPUTS w Any descendant of the root shell for which application resource values are to be obtained. args An ArgList specifying the names of resources to be queried or set, and the addresses of variables to store their values in (for XmtGetApplicationValues()) or the values to set for those resources (for XmtSetApplicationValues()). num_args The number of elements in the args array. DESCRIPTION XmtGetApplicationValues() and XmtSetApplicationValues() are analogs to XtGetValues() and XtSetValues(). Instead of querying and setting the re- sources of a widget, however, they query and set the standard Xmt applica- tion resources associated with a root shell widget. See Chapter 7, Applica- tion Resources and Command-Line Arguments, for a complete list of these ap- plication resources. The header file <Xmt/AppRes.h> contains symbolic names that you can use to refer to each of these application resources-each name begins with an XmtN prefix, just as Xmt widget resource names do. Xmt does not make copies of any of its string application resources, so any strings returned by XmtGetApplicationValues() must not be modified or freed. Similarly, Xmt does not make copies of any of its string application resources, so any string values set by this function must be constant strings, of must not be modified or freed for the lifetime of the applica- tion. Not all application resources can be meaningfully set. Xmtforeground and XmtNbackground, for example, are used only within XmtInitializeApplication- Shell() and are never referenced again; setting them will have no effect. Calling XmtSetApplicationValues() only sets the specified values; Xmt makes no attempt to update the current application state to reflect the new val- ues. If the ``busy cursor'' is being displayed by XmtDisplayBusyCursor(), for example, and you set the XmtNbusyCursor resource, the cursor that is displayed will not change. The next time you call XmtDisplayBusyCursor(), however, the new cursor will be used. SEE ALSO Chapter 7, Application Resources and Command-Line Arguments, XmtInitializeApplicationShell(), XmtParseCommandLine(). Xmt Motif Tools XmtGetApplicationValues(3)
NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmtGetApplicationValues&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>