The new FXRuler widget is a kind of frame that can be placed alongside some other widget to measure the position and size of elements inside that widget. An example of this, from the scribble.cpp test program, is shown below.
There are a number of different options available to modify the appearance and behavior of an FXRuler object:
A ruler can be drawn horizontally (the RULER_HORIZONTAL option) or vertically (the RULER_VERTICAL option). The default is to draw the ruler horizontally.
The display of tick marks for a horizontally-aligned ruler is controlled by the RULER_TICKS_OFF, RULER_TICKS_BOTTOM, RULER_TICKS_TOP and RULER_TICKS_CENTER options. The tick marks are drawn as short vertical lines, either above the ruler's center line (the RULER_TICKS_TOP option), below the center line (the RULER_TICKS_BOTTOM option) or, you know, centered on the center line (the RULER_TICKS_CENTER option). By default, no tick marks are displayed. Note that for a vertically-aligned ruler, the tick marks are drawn as horizontal lines and the RULER_TICKS_LEFT and RULER_TICKS_RIGHT options take the place of the RULER_TICKS_BOTTOM and RULER_TICKS_TOP options.
When the RULER_MARKERS option is selected, a small downward-pointing arrow is drawn inside the ruler to indicate the first line's indent and two upward-pointing arrows are drawn to indicate the left and right indents for subsequent lines.
When the RULER_ARROW option is selected, a small triangle that "tracks" the current mouse cursor position is drawn inside the ruler.
As of this writing, the FXRuler widget still seems to be under development. For example, there's no way to set the values of the first line, left and right indent values for the RULER_MARKERS option. Furthermore, it does not appear that the RULER_ENGLISH, RULER_NUMBERS or RULER_METRIC options have been implemented at all (which is why they aren't mentioned in the above listing). One should expect that this widget will be developed further for the next major release of FOX.