flagwin

flagwin [<on>|off]

Turns on or off a window providing a continuous display of the machine flags (e.g. zero, carry).

See Also: pflags.

flowobj

flowobj

Examples:

"pobject [flowobj]": print out the flow object.

Prints out address of the uiFlowObj, which is the object which grabs the mouse.

This command is normally used with pobject to print out the object.

flush-output

flush-output

Examples:

"flush-output": Forces pending output to be displayed.

Flushes any pending output (e.g. waiting for a newline) to the screen.

See Also: echo.

fmtoptr

fmtoptr <handle-id> <chunk>

Examples:

"fmtoptr 3160h o": Prints a description of the object whose address is ^l3160h:0 (likely a thread/process).

Takes a global and a local handle and prints a description of the object described by that optr.

If the global handle is a thread or a process, the thread's name (process thread for a process handle) and the chunk handle (as an additional word of data for the message) are printed.
If the global handle is a queue handle, the queue handle and the chunk handle are printed, with a note that the thing's a queue.
If Swat can determine the object's class, the optr, full classname, and current far pointer are printed. In addition, if the chunk has its low bit set, the word "parent" is placed before the output, to denote that the optr likely came from a link and is the parent of the object containing the optr.

See Also: print.

fmtval

fmtval <value-list> <type-token> <indent> [<tail> [<one-line>]]

Examples:

"fmtval [value fetch foo] [symbol find type FooStruct] 0": Prints the value of the variable foo, which is assumed to be of type FooStruct.

This is the primary means of producing nicely-formatted output of data in Swat. It is used by both the "print" and "_print" commands and is helpful if you want to print the value of a variable without entering anything into the value history.

<value-list> is the return value from "value fetch". You can, of course, construct one of these if you feel so inclined.
<type-token> is the token for the type-description used when fetching the value.
<indent> is the base indentation for all output. When "fmtval" calls itself recursively, it increases this by 4 for each recursive call.
<tail> is an optional parameter that exists solely for use in formatting nested arrays. It is a string to print after the entire value has been formatted. You will almost always omit it or pass the empty string.
<one-line> is another optional parameter used almost exclusively for recursive calls. It indicates if the value being formatted is expected to fit on a single line, and so "fmtval" should not force a newline to be output at the end of the value. The value should be 0 or 1.

See Also: print, _print, fmtoptr, threadname.

focus

focus [<object>]

Examples:

"focus": print focus hierarchy from the system object down
"focus -i": print focus hierarchy from implied grab down
"focus ^l4e10h:20h": print focus hierarchy from ^l4e10h:20h down
"focus [content]": print focus hierarchy from content under mouse.

Prints the focus hierarchy below an object.

If no argument is specified, the system object is used.
The special object flags may be used to specify <object>. For a list of these flags, see pobject.
Remember that the object you start from may have the focus within its part of the hierarchy, but still not have the focus because something in a different part of the tree has it.
The variable "printNamesInObjTrees" can be used to print out the actual app-defined labels for the objects, instead of the class, where available.

This variable defaults to false.

See Also: target, model, mouse, keyboard, pobject.

focusobj

focusobj

Examples:

"focusobj": print model hierarchy from system object down
"pobj [focusobj]": Do a pobject on the focus object (equivalent to "pobj -f").

Returns the object with the focus.

See Also: focus, target, model, targetobj, modelobj.

fonts

fonts [<args>]

Examples:

"fonts": summarize general font usage
"fonts -u": list fonts currently in use

Print various font info.

The <args> argument may be any of the following:

-a: list of fonts available
-d: list of font drivers available
-u: [<ID>] list of fonts currently in use. Optional font ID to match.
-s: summary of above information

If no argument is specified the default is to show the summary.

When using other commands you probably need to pass them the handle in FIUE_dataHandle . When you don't have the font's handle ready, the best way is to use "fonts -u" to find the font at the right point size and then grab the handle from there.

See Also: pfont, pfontinfo, pusage, pfontinfo.

GEOS SDK TechDocs |

fatalerr_auto_explain ... | Next:

fpstack ...