GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  XMTGETAPPLICATIONVALUES (3)

NAME

XmtGetApplicationValues(), XmtSetApplicationValues() - query and set application resources by name.

CONTENTS

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 resources of a widget, however, they query and set the standard Xmt application resources associated with a root shell widget. See Chapter 7, Application Resources and Command-Line Arguments, for a complete list of these application 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 application.

Not all application resources can be meaningfully set. Xmtforeground and XmtNbackground, for example, are used only within XmtInitializeApplicationShell() 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 values. 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().
Search for    or go to Top of page |  Section 3 |  Main Index


Xmt XMTGETAPPLICATIONVALUES (3) Motif Tools

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.