6 .Nd simple menu for XOrg
10 utility a simple graphical menu for XOrg. It read the items from
12 and print the user selection to
17 Most of the appearance of the menu is defined through the \fBX
20 Application specific resources:
23 The font name, only bitmap font are supported. By default is set to
26 The layout of the menu. The possible values are "horizontal" and
27 "vertical", with the default being "horizontal". Every other value
28 than "horizontal" is treated like "vertical", but this is kinda an
29 implementation detail and not something to be relied on, since in the
30 future other layout could be added as well.
32 A string that is rendered before the user input. Default to "$ ".
34 The width of the menu. If a numeric value is given (e.g. 400) is
35 interpreted as pixel, if it ends with a percentage symbol `%'
36 (e.g. 40%) the relative percentage will be computed (relative to the
39 The height of the menu. Like MyMenu.width if a numeric value is given
40 is interpreted as pixel, if it ends with a percentage symbol `%' the
41 relative percentage will be computed (relative to the monitor height).
43 The X coordinate of the topmost left corner of the window. Much like
44 MyMenu.height and MyMenu.width both a pixel dimension and percentage
45 could be supplied. In addition to it, the special value "middle" could
46 be used: in that case the window will be centered on the x axes.
48 The Y coordinate of the topmost left corner of the window. Like the X
49 coordinate, pixel dimension, percentage dimension and the special
50 value "middle" could be supplied.
51 .It MyMenu.prompt.background
52 The background of the prompt.
53 .It MyMenu.prompt.foreground
54 The text color (foreground) of the prompt.
55 .It MyMenu.completion.background
56 The background of the completions.
57 .It MyMenu.completion.foreground
58 The text color of the completions.
59 .It MyMenu.completion_highlighted.background
60 The background of the selected completion.
61 .It MyMenu.completion_highlighted.foreground
62 The foreground of the selected completion.
66 .Bl -tag -width indent-two
68 Close the menu without selecting any entry
70 Close the menu and print to stdout what the user typed
74 Expand the prompt to the next possible completion
76 Expand the prompt to the previous possible completion
78 Delete the last character
90 If, instead of a numeric value, a not-valid number that terminates
91 with the % sign is supplied, then the default value for that field
92 will be treated as a percentage. Since this is a misuse of the
93 resources this behavior isn't strictly considered a bug.
98 0 when the user select an entry, 1 when the user press Esc and
99 EX_UNAVAILABLE if the connection to X fails.
106 .An Omar Polo <omar.polo@europecom.net>