|
Unix VPS
Support
FAQ
Network
Miscellaneous
|
| XmtSymbolSetValue(3) | FreeBSD Library Functions Manual | XmtSymbolSetValue(3) |
NAME
XmtSymbolSetValue(), XmtSymbolGetValue() - set or query the value of a symbol.SYNOPSIS
void XmtSymbolSetValue(XmtSymbol s, XtArgVal value)
void XmtSymbolGetValue(XmtSymbol s, XtArgVal *valuep)
ARGUMENTS
INPUTS- s
- The XmtSymbol that is to have its value queried or set.
- value
- For XmtSymbolSetValue(), the new value for the symbol.
OUTPUTS
- valuep
- For XmtSymbolGetValue(), the address at which to store the value of the symbol.
DESCRIPTION
XmtSymbolSetValue() sets the value of symbol s to value. Recall that an XtArgVal is the type used by Xt for untyped values passed to XtSetArg(). As when you are setting resources, you should pass the value itself, if it will fit within an XtArgVal, and otherwise, you should pass the address of the value (you rarely have to do this, however, except when you are using a double value.) Also, notice that XmtRBuffer is a special case here-you always pass the address of the buffer, no matter its size.XmtSymbolGetValue() stores the current value of the symbol s at the address specified by value. Note that valuep need not actually be the address of an XtArgVal variable, but must be large enough to store the value of the Symbol-you must know the type of the symbol in order to pass an appropriate val uep.
Note that the module that registers a symbol can obtain that symbol's value by reading it directly from the address registered with the symbol-there is no need to read it indirectly with XmtSymbolGetValue().
SEE ALSO
Chapter 12, Symbols,XmtLookupSymbol(), XmtSymbolAddCallback(), XmtSymbolRemove Callback(), XmtVaRegisterSymbols().
| Motif Tools | Xmt |
Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.