The colors, fonts, layout arrangements, and many other aspects of the appearance of a screen display are controlled by display attributes. "Screen Management Functions" tells how to use the screen management primitive functions of and has to set and reference values of display attributes.Every display attribute is listed in "Display Attributes", together with a brief description and a set of keys. The meanings of the alphabetic keys are given in the next section.
For some display attributes, the information in "Display Attributes" is only a summary. For more information on:
- Keys with capital letters indicate the display classes for which an attribute is meaningful.
- Keys in lower case letters generally indicate characteristics of the attributes.
- Links to additional information about the attributes are indicated by "more".
Among the display attributes described here are those for specifying colors and fonts. Both colors and fonts are specified by symbols or character strings, as in `name or 'name'. A list of all available color names can be found in "/usr/X11R6/lib/X11/rgb.txt".
- Functional attributes, see "Functional Attributes";
- Attributes with callbacks, i.e., event attributes, consult "Attributes with Callbacks";
- User interactions related to certain attributes, such as select, see "User Interactions with Displays";
- Variables and additional functions related to attributes, consult "The s Context", including the "Attribute Default Variables" section. "Null (0)" or "Null (1)" in the Default column indicates the attribute will mirror a default variable whose default value is 0 or 1, respectively.
For convenience, a list pruned to the unique colors appears in "Colors". A list of all available font names can be produced by executing xlsfonts in an XTerm session (or $xlsfonts from A+). A list of preferred fonts (those available on the screen and for printing) is in "Preferred Fonts".
Display attributes are categorized as persistent and nonpersistent. Persistent attributes can be thought of as more directly connected to the concept of an array than nonpersistent ones. For example, the font in which the values of a variable will appear is a persistent attribute, while the thickness of the highlight border in its display is nonpersistent. The most distinguishing feature is that once a persistent attribute is set for a variable x, it will remain set, even as x is bound, freed, and bound again to another class; in effect, a persistent attribute is an attribute of A+ variables, not of particular display classes. Indeed, it can be set on an unbound variable. For this reason persistent attributes are also called attributes of variables. On the other hand, the setting of a nonpersistent attribute will not be maintained when a variable is freed, and some nonpersistent attributes cannot even be specified for variables bound to certain classes. Nonpersistent attributes are attributes of display classes, not of variables bound to those classes. Nonpersistent attributes are also called attributes of classes, or widget attributes.Even though a persistent attribute can be given a value for an object of any class, that value is not necessarily meaningful. For example, the font attribute, which specifies the font in which values are type set, is not meaningful for line graphs. For each persistent attribute, "Display Attributes" shows "ALL" as the key for the set of display classes to which it applies and - unless it is meaningful for all classes - lists in parentheses the classes for which it is actually meaningful, i.e., for which it has a visual effect. Note that an object contained in a table or graph is bound to the class tableField or graphTrace, respectively, no matter to what class it may have previously belonged.
Keys with capital letters in the second column of "Display Attributes" indicate classes to which the attributes apply. The ALL key means all classes except report, which is fundamentally different from the others, since it cannot be shown, and in some cases, such as navigation, children of reports. Only Rp refers to the report class. CNT means the container classes hgrid, hpane, layout, notebook, vgrid, and vpane.
Objects in layouts and panes have attributes for establishing their relative positions and behavior when the layouts are resized. See "Layouts, Geometry, Constraints", and also "The Layout Display Class".
Top-level objects, in the broad sense1, are objects that are not contained in other objects (and not reports). It is these objects that appear with certain window manager decorations, and there are attributes associated with this appearance and their interrelations among top-level objects. See "Windows" in "Introduction to Screen Management".
Graphs have four axes, the x axis on the bottom of the plot area, the y axis to the left, an alternate x axis above, and an alternate y axis to the right. Some attributes come in sets of four, with one attribute for each axis. For example, the font for the labels can be set separately for each axis, as xlabelfont for the x axis, ylabelfont for the y axis, Xlabelfont for the alternate x axis, and Ylabelfont for the alternate y axis. Whenever there is such a foursome, only the attribute for the x axis is given, with the key o.Similarly, for several attributes there are x-axis and alternate x-axis versions, but no y-axis or alternate y-axis versions. For these attributes, only the attribute for the x-axis is given, and with the key x. Analogously, for attributes with y-axis and alternate y-axis versions, but no x-axis or alternate x-axis versions, only the attribute for the y-axis is given, with the key y.
Certain attributes express an action to be taken, rather than a quality. For example, naturalsize is the attribute which causes an object to be resized to a size appropriate for its current value and attribute settings. It is not necessary to specify a value for this attribute, but only that the resizing actions should take place, as in`object has `naturalsizeSome action attributes also take values, but it is not necessary to specify a value to get the primary action to take place. For example, the show attribute can be given the value 1 to show an object or 0 to hide it, and
`object has (`show;1) is equivalent to `object has `show.
Some attributes can only be set, and have no stored value; s will complain if asked for a value. Other attributes can only be referenced; s will complain about any attempts to set values for them.
These attributes are associated with user interactions such as key and button presses. See "Attributes with Callbacks". This key is used as a link to the corresponding table entry in that chapter. Some attributes with this key have a default value of 0 or 1 and can also be given the other value of 1 or 0; in these cases either `false or `off can be used in place of 0, and either `true or `on can be used in place of 1.
These attributes provide efficient means for dynamically modifying their values based on changing circumstances in running applications. See "Functional Attributes". This key is used as a link to the corresponding table entry in that chapter.
The second column of this large table shows keys which explain the applicability of each attribute. To see a brief description of what a key represents, simply point to they key with your mouse... no clicking required.Alternatively, assuming you are using the frames version of the online manual, when you are looking at an entry in the table and are not sure what a key stands for, you can click on "Keys" under "Table of Attributes" in the lefthand frame. After ascertaining the key's meaning, you can return to the table by pressing the righthand mouse button with the pointer in the main frame and selecting "Back" from the menu that pops up.
Attribute
Meaning
A array B label C command D password E choice G graph gT graphTrace hG hgauge hM hmenu hP hpane hR hgrid hS hscale I radio K check L layout M matrix N action O notebook P page Q scalar R tree Rp report S slot T table tF tableField U button V view vG vgauge vM vmenu vP vpane vR vgrid vS vscale W window X text ALL all objects except reports (fundamentally different; can't be shown) ALL (list) ALL, but meaningful only for the classes in list CNFT NFT but only objects in containers CNT containers: layout, grids, panes, and notebook GS hgauge, vgauge, hscale, and vscale NFT not tableField or graphTrace TOP top-level and popup objects only o also for graph attributes prefixed X, y, Y, or x also for the attribute with prefix X y also for graph attribute prefixed Y a action cb attribute with callback fn functional p persistent r reference only (cannot be set) s set only
Attribute | Keys (POINT TO KEY FOR INFO) |
Description | Default |
---|---|---|---|
b | ![]() | If 1, bottom justify this object in its layout cell. | 0 |
backpagebg | ![]() | Background color of tabs and page edges. | `deep skyblue4 |
backpagefg | ![]() | Foreground color of tabs and page edges, but not the titles on the tabs, which get their color from fg. | `black |
backpages | ![]() | Number of apparent unshown pages, i.e., page edges. | 3 |
backpage thickness | ![]() | Thickness of each (unshown) page edge, in pixels. | 4 |
banner | ![]() | Text of banner to be printed diagonally in background on each page, e.g., "Draft", "Internal use only". | |
barwidth | ![]() ![]() | The maximum pixel width of bars in bar and stack graphs. | 10 |
be | ![]() ![]() ![]() ![]() | If (cÖv) has (`be;(f;s)) and cÖv is a container, then f{s;d;i;p;c;v} is called to bind the child d of cÖv to a display class; s may be a display class, a list of display classes, or whatever will help in this process. | |
bg | ![]() ![]() ![]() ![]() ![]() ![]() ![]() | The background color of this object. For tables and arrays, does not change the scrollbar background color if that color is different from the bg color that is being changed. A tableField inherits its value from its table, and when the value for tableField is reset to Null it uses the current value for table. | grey |
bggrayscale | ![]() ![]() | Background shade value in reports, 1 - white to 0 - black. A scalar or a function (in the callback i is the row). | 1 |
bindingwidth | ![]() | The width (diameter) of the spiral binding, in pixels. | 36 |
blank | ![]() ![]() ![]() ![]() ![]() ![]() | What is to be displayed for a NA, e.g., on insertion of a row. Cf. na and s.AUTOBLANK. | Null |
blink | ![]() ![]() ![]() | Boolean mask controlling whether or not a cell blinks, i.e., its foreground and background colors oscillate. (The blink timer runs only when something is actively blinking). | |
blinkrate | ![]() | The rate of blinking in milliseconds. | 250 |
bold | ![]() ![]() | Boolean mask indicating which characters are bold. | |
borderheight | ![]() | Border area above and below the notebook, in pixels. | 7 |
borderwidth | ![]() | Border area on each side of the notebook, in pixels. | 7 |
bottom | ![]() ![]() | Distance from the bottom of the graph window to the x-axis rule (visible or not), as a percentage of the window height. | 0 |
bottom margin | ![]() | Bottom margin of report, in inches. | 1 |
bound | ![]() ![]() ![]() | If 1, this object is bound; if 0, this object is free. | |
box | ![]() ![]() | An n by 4 matrix of boxes, where each row represents a box as first row, first col, number of rows, number of columns. | 0 4 Ò 0 |
boxcolor | ![]() | A symbolic vector of box colors. If boxcolor is specified with fewer colors than boxes, then the remaining boxes stay the color that they were before the specification. | |
breakbggray scale | ![]() ![]() | Background shade for breaks in reports, 1 - white to 0 - black. A scalar or function. | 1 |
breakcriteria func | ![]() ![]() | Determines whether a break occurs for this row (propagated to other columns). Must be functional and return 0 or 1. | If row (item) differs from previous row. |
breakfggray scale | ![]() ![]() | Foreground shade for breaks in reports, 1 - white to 0 - black. A scalar or function. | 0 |
breakfont | ![]() ![]() ![]() | Font to be used for printing breaks. Value for table is used as a default if no value set for a tableField. | |
breakleading | ![]() ![]() | Distance in points between break and next row. | 2 |
breakoffset | ![]() ![]() | Distance in points between break and previous row. | 2 |
breakon | ![]() | Whether column can initiate breaks or not. | 0 |
break processfunc | ![]() ![]() | Function to be called to process data at a break if breakprocesson is 1. If none, computation mode is used. | |
break processon | ![]() | Whether to perform computations at breaks. | 1 |
breakstyle | ![]() ![]() ![]() | Style for break: `left, `right, `top, `bottom, or a combination. Value for table used as default. | `left |
breaktext | ![]() | Text to be inserted at every break. | |
buffer | ![]() ![]() ![]() | The character buffer of the command or text display class; a vector. | |
build | ![]() ![]() ![]() ![]() | If 1 and this object is a simple vector layout, use autobuilder; if 0, use a default arrangement; if Null, use the value of s.AUTOBUILD. | Null (0) |
Attribute | Keys (POINT TO KEY FOR INFO) |
Description | Default |
---|---|---|---|
C | ![]() ![]() ![]() ![]() ![]() ![]() ![]() | If 1, make all virtual columns of this object the same size. | |
cancel | ![]() | Set to 1 (in a callback) to cancel report generation. | 0 |
children | ![]() ![]() ![]() ![]() | A vector of all objects named in this variable. | |
class | ![]() ![]() | The display class of this object. | |
clear | ![]() ![]() ![]() | Furnishes a callback function for a clear event. See "Accessing the Primary Selection Buffer". | |
col | ![]() ![]() ![]() ![]() | The column index of the selected cell. Setting this attribute causes the selected column to appear in the display. In addition, if the row attribute is set to a valid row index, the cell at position (row, col) is highlighted. Setting it to -1 signifies that no column is selected (so none is highlighted). | 0 |
colindex | ![]() | A vector of indices of the selected column labels when the selectcol attribute is 1, in the order of selection. | É0 |
colindexbg | ![]() | The background color of the indexed column labels. | medium aquamarine |
collabelrows | ![]() | The maximum number of rows in the column labels. | 1 |
color | ![]() ![]() | Row indices for colormap attribute, for foreground, background color pairs for cells. Functional result must be same shape as variable; if nonfunctional, it is reshaped to match. | Null (0) |
colormap | ![]() | k by 2 matrix of color symbols; each row is a foreground, background pair. Indexed into by the color attribute. | 1 2 Ò `black `grey |
colors |
![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | A vector of colors that will be cycled through when a cell is updated by indexed specification (which can be caused by editing the cell on screen); see the cycle attribute. | |
cols | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | The number of visible columns. | Table: at most 5; text: 40. |
colsep | ![]() ![]() ![]() ![]() | If n, column separators appear every n columns. | 1 |
colspace | ![]() ![]() | An integer vector specifying column widths. The first element applies to the row-label column. If there is only one element, it applies to all columns. Otherwise, all elements except the first are used cyclically, as in Reshape. | Null |
column alignment | ![]() | Horizontal alignment of data in the tableField. One of `left, `center, `right. | `left |
column control | ![]() | Vector of columns per page. | |
column pagespan | ![]() | Number of pages that the table's columns are to span. | |
column resize | ![]() ![]() | Controls whether columns can be resized by dragging their right borders (column separators): 1 - yes, 0 - no. | 0 |
column spacing | ![]() | Space between columns in reports, in inches. | |
computation mode | ![]() | Specify the default computation mode: `sum, `avg, `max, `min, `stddev, `variance. Used when breakprocesson is 1 and breakprocessfunc is not specified. | |
compute pagebreakcb | ![]() ![]() | For a callback that occurs at the completion of the pagebreak computation. | |
compute sizecb | ![]() ![]() | For a callback that occurs at the completion of the computation of the report size. | |
constraints | ![]() ![]() ![]() ![]() | A slotfiller containing the resize attribute of each child, indexed by child's name. | Defaults for the children |
coordinate | ![]() ![]() |
The pointer's x, y coordinates when a refer event occurs. | ![]() ![]() |
All the x axis, y axis coordinates that make up the trace when a refer event occurs. |
Coordinate | ![]() ![]() | The pointer's X, Y coordinates when a refer event occurs. | |
copy | ![]() ![]() ![]() ![]() ![]() ![]() | For an inserted line. If 1, copy the line that the new line is being inserted above or below. If 0, use na value. Cf. s.AUTOCOPY. | Null (0) |
copy texttrace | ![]() ![]() ![]() | The action taken on a copy-a-text-trace event. | |
copytrace | ![]() ![]() ![]() | The action taken on a copy-a-trace event. | |
cornerindex | ![]() | If 1, the corner label is "flagged"; if 0, it is not; see the selectcorner attribute. | 0 |
corner indexbg | ![]() |
The background color of the corner label when it is flagged. | medium aquamarine |
current breakcolumn | ![]() ![]() | Column that is currently causing a break. | |
current page | ![]() | Name of the object that is being shown. Set it to show page. | |
cursor | ![]() ![]() ![]() | The position of the cursor (number of characters from the left and, for page, top). | page: ¢1 ¢1; others: 0. |
cycle | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | The duration in milliseconds of the appearance of each color in the value of the colors attribute. If set on a table, it applies to all tableFields. | |
cyclemode | ![]() ![]() ![]() ![]() |
If `fg, color cycling affects the foreground, if `bg, the background; if `reverse, color cycling is implemented by reverse video and the colors attribute is ignored. | `fg |
Attribute | Keys (POINT TO KEY FOR INFO) |
Description | Default |
---|---|---|---|
decrement | ![]() ![]() ![]() ![]() ![]() | An event callback function to be associated with the down arrow button that appears when arrowbuttons is 1. For a slot, there may be several down arrow buttons; the selected attribute gives the symbol for the entry whose button was pressed. | |
deiconized | ![]() ![]() | Function for event callback when the widget is deiconized, whether or not the window manager is CDE. See the caveats in the callback section. Cf. iconized. | |
delete | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | Controls the action when a user presses Meta-Delete or, on IBM, Alt-Delete. The default action is to delete the selected row. Set delete to 0 to turn off the Delete key, and 1 to get the default action. In the case of a graph, it applies only to selectable traces. See the selectable attribute. | 0 |
delimiter | ![]() | To be defined. | |
descendents | ![]() ![]() ![]() ![]() ![]() | A vector of all objects contained in this object. | |
disclaimer | ![]() | Governs disclaimer: `none; `text only; text in `box; text with `rule above and below; text below `toprule; or text `appended to top-level window. | `none |
disclaimer bottom margin | ![]() | The bottom margin of the disclaimer, in inches. | .2777777778 |
disclaimer file | ![]() | The file containing the disclaimer text. | |
disclaimer leftmargin | ![]() | The left margin of the disclaimer, in inches. | .2777777778 |
disclaimer right margin | ![]() | The right margin of the disclaimer, in inches. | .2777777778 |
disclaimer rule width | ![]() | Width of any ruling for the disclaimer; see the disclaimer attribute. | |
disclaimer topmargin | ![]() | The top margin of the disclaimer, in inches. | .2777777778 |
disclaimer orientation | ![]() | Orientation of the disclaimer: same as the object if `none; else `portrait or `landscape regardless of the object. | `none |
distribution method | ![]() |
`linear or `table, indicating distributionlevels evenly spaced separators or the separators in distributiontable. | `linear |
doc | ![]() ![]() | An attribute that allows documentation, presumably text, to be attached to each object. Cf. s.AUTODOC. | >,< s.AUTODOC |
done | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | Holds the name of a function to be called at the end of the screen entry and refresh cycle. (The cycle is: in, preset callback, assignment, set callback, out, done.) | |
downto | ![]() | Object to which Shift-down-arrow moves keyboard focus. Connected to arrowlist. [Future use] | Null |
dragdrop | ![]() ![]() | Controls whether columns can be moved by dragging: 1 - yes, 0 - no. | 0 |
dynamic | ![]() | Set to 1 for this object to be resized automatically when necessary due to a font or text change. | 0 |
Attribute | Keys (POINT TO KEY FOR INFO) |
Description | Default |
---|---|---|---|
edit | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | When edit is set to any nonzero value, if there is a selected cell and it is not protected, it is put in input (editing) mode. When edit is set to 0, if there is a cell in input mode, its contents are accepted and input mode ended, as if the viewer had pressed Enter while the pointer was in the object. | |
editbegincb | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | The callback function to be executed when a user begins editing the widget. | Null (none) |
editbg | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | The background color of the cell being edited. | black |
editendcb | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | The callback function to be executed when a user ends editing of the widget. | Null (none) |
editfg | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | The color of the text being entered while in edit mode. | grey |
editspace | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | If 0, the space for editing is the same as the current value of the space
attribute; if 1, the value of s.EDITSPACE; if Null, the value of s.AUTOEDITSPACE. | |
eval | ![]() ![]() ![]() | Nested pair: variable callback function, static data. Function is called after the variable is evaluated (by %). | |
evaluate | ![]() ![]() | If 0, the variable is not to be evaluated in determining proper attributes for display; they will be set by the application programmer. Use with great caution. | Null (1) |
execute | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | If 1, execute input expressions to obtain a value; if 0, don't. The table value is used for a tableField if the tableField's value is null. | Null (1) |
exit | ![]() ![]() ![]() | Controls the action taken when a user attempts to remove this object from the screen. The default iconification-or-removal behavior occurs for the default value. | 1 |
extent | ![]() | Location and size of an object that is shown: the vector y, x, ys, xs. For a child y and x are relative to its parent. | |
extents | ![]() ![]() | A slotfiller whose indices are the names of all non-container, non-tableField, non-graphTrace descendents and each of whose values would be the extent attribute for the corresponding descendent except that the locations are absolute (relative to the screen, not to parents). | Always a null slotfiller except for top-level CNT. |
Attribute | Keys (POINT TO KEY FOR INFO) |
Description | Default |
---|---|---|---|
f1 through f12 | ![]() ![]() | Controls the action when the F1 - F12 keys are pressed and this object has focus. | |
familytree | ![]() ![]() ![]() ![]() ![]() | A nested slotfiller of all objects contained in this object. | |
fg | ![]() ![]() ![]() ![]() ![]() | The foreground color of this object, usually text or values.
For tables, cells of any tableField for which fg is not explicitly set. For tableFields, cells. For page objects, the boxes on the page. For check and radio objects, a value area button when the corresponding value is 1. For check, choice, label, radio, tableField, this attribute can be a list of values, which will be used cyclically - in the manner of Reshape - to assign colors to the value area buttons or rows individually; note that for choice, the chosen item is displayed in the value area, whereas the items in the dropdown list are labels. (If this attribute is a list for a table, only the first value is used.) For graph, applies to everything except the title and traces. | |
fggrayscale | ![]() ![]() | Foreground shade value in reports, 1 - white to 0 - black. A scalar or a function (in the callback i is the row). | 0 |
field | ![]() | The symbol of the selected field, i.e. column. The field and col attributes always indicate the same column. Setting field to Null is the same as setting col to -1: no field is selected. | |
fields | ![]() | The number of visible fields, or columns. | |
filename | ![]() | The name of the output file. | report.ps |
fill | ![]() | The character displayed for every keyboard entry in the value area; '' for no fill. | * |
fillcolor | ![]() ![]() ![]() | The fill color of various graph styles. | |
firstcol | ![]() ![]() ![]() ![]() | The index of the first visible column. | 0 |
firstfield | ![]() | The symbol of the leftmost displayed field of this object. | |
firstrow | ![]() ![]() ![]() ![]() | The index of the first visible row of this object. | 0 |
fixedfields | ![]() | The number of fixed fields of this object, i.e., fields on the left that do not participate in horizontal scrolling. The screen-display analogue of fixedreportcolumns. | 0 |
fixedreport columns | ![]() | The number of leftmost table columns that are to appear on the left side of each page of a report for this table. The printed analogue of fixedfields. | 0 |
fkeys | ![]() ![]() | A slotfiller of function key, callback fn pairs for this object. | |
focus | ![]() | Set to any value to give this object keyboard focus. | |
followers | ![]() ![]() | A vector of symbols whose objects are removed from the screen when this object is iconified. | |
followertree | ![]() ![]() | The followers of this object, in a boxed array. | |
font | ![]() ![]() ![]() ![]() ![]() | The font in which the value of this variable is set.
For table, used for any tableFields for which font is not explicitly set. For graph, applies only to characters used as symbols in scatter and line-scatter traces. | kaplgallant |
foot | ![]() | If 1, include a footnote area at the bottom of this object. | |
footer | ![]() | The footer text. | |
footer offset | ![]() | The space above the footer text, in inches. | 2 |
footnote |
![]() ![]() | The footnote text, a character matrix or vector of vectors. If empty or null, no footnote area is shown. | Null (none) |
footnote font |
![]() ![]() | The font in which the footnote is type set. | kaplgallant-19 |
footnote justify |
![]() ![]() | Justify the footnote relative to the margins set with the bottom, top, left, and right attributes. | |
format breakfunc | ![]() ![]() | The variable callback function that formats the break text. The d parameter contains the unformatted text. | |
framebg | ![]() | The color of the frame background. | `deepskyblue4 |
frame linewidth | ![]() ![]() | Page frame line width. | 0 (thinnest) |
frameoffset | ![]() ![]() | Page frame offset; the spacing between frames, in inches. | 2 |
framestyle | ![]() ![]() | Page frame style: `center, `left, `right, `top, `bottom, or a combination, or `none. | `none (null) |
frame thickness | ![]() | The frame thickness in pixels. | 2 |
freeze | ![]() | If 1, setting attributes or respecifying variables will not alter the display of the object and its descendents; if 0, they will. Resetting to 0 will cause at least redrawing; for a layout, repositioning. Warning: if color cycling is on for an object, updates that occur while it is frozen will miss the first color, including updates followed immediately by unfreezing. | 1 |
fullscreen | ![]() ![]() | Make the window exactly as large as the screen and put it at location 0, 0. Setting fullscreen to 0 has no effect. | 0 |
Attribute | Keys (POINT TO KEY FOR INFO) |
Description | Default |
---|---|---|---|
geometry | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | The arrangement of slots in the display of a slotfiller object. | 1 |
gradient | ![]() ![]() ![]() | If 1, cycle through s.FILLCOLORS for every data point in a scatter plot or bar graph. If a function, call it for each point. | 0 |
grid | ![]() ![]() | Specify the axes that control the grid lines, or none. | |
gridfg | ![]() ![]() | The color of the grid lines. | |
gridstyle | ![]() ![]() | The style of the grid lines (solid, dotted, etc.). | |
gridwidth | ![]() ![]() | The width in pixels of the grid lines. | 0 (thinnest) |
h | ![]() | If 1, don't change the height of this object's row on resize. | 1 for hmenu |
H | ![]() | If 1, do not change the height of this object on resize. | 1 for hmenu |
has | ![]() ![]() | If 1, whenever an attribute value is changed, report the new setting in the A+ session log, as a set of comments. | 0 |
head | ![]() | If 0, remove the window manager's header on this object (including, of course, the pin). | 1 |
header | ![]() | The header text. | |
header offset | ![]() | The space below the header text, in inches. | 2 |
headingbg grayscale | ![]() | Background shade value in reports, 1 - white to 0 - black. A scalar or a function (in the callback i is the row). | 1 |
headingfg grayscale | ![]() | Foreground shade value in reports, 1 - white to 0 - black. A scalar or a function (in the callback i is the row). | 0 |
heading style | ![]() ![]() | Heading style in reports: `left, `right, `top, `bottom, or a combination, or `none. | `none (null) |
hide | ![]() ![]() | Set to any value to hide this object. In a child of a layout, it must be set after the layout is shown, since show for a layout sets show for its children. See `show. | |
hl | ![]() | The highlight border color when the object has focus. | yellow |
hlthickness | ![]() | The width in pixels of the highlight border around the object. | 2; 0 for menus. |
horizontal space | ![]() | The minimum distance between nodes in the same row of the widget, in pixels. | 15 |
hscrollsize | ![]() ![]() ![]() ![]() | The height in pixels of horizontal scrollbars on this object. | 15 |
hscrollwith | ![]() ![]() ![]() ![]() ![]() | A list of names, in symbol form, of objects whose horizontal scrolling and column selection is to be synchronized with this object's; see the setfirstcol and setcol attributes. | 0Ò` |
Attribute | Keys (POINT TO KEY FOR INFO) |
Description | Default |
---|---|---|---|
icon | ![]() | An n x m boolean matrix of the bitmap pattern for the icon of this object, where n and m are at most 64. Appears in reverse video. | |
iconic | ![]() | If 1, this object is a top-level window; if 0, a popup. This attribute has no effect on the object named in s.WS when s.AUTOWS is 1. s.WSû`a;`a has (`iconic;0) produces an error message. | |
iconized | ![]() ![]() | Function for event callback when the widget is iconized. Also see deiconized. | |
icontitle | ![]() | The title of the icon for this object. | |
in | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | Used to parse values entered on the screen, which are always in character vector form. Values of this attribute are usually functions. However, if the value is a character matrix and the character vector read from the screen is a row of this matrix, the value created for the workspace is the row index. | in x:x for character workspace values; in x:âx otherwise. |
inc | ![]() | The change in value when an arrow key is pressed: left or up, an increase; right or down, a decrease. Accepted for gauges, but meaningful only for scales. | 1 |
increment | ![]() ![]() ![]() ![]() ![]() | An event callback to be associated with the up arrow button that appears when arrowbuttons is 1. For a slot, there may be several up arrow buttons; the selected attribute gives the symbol for the entry whose button was pressed. | |
incurrent workspace | ![]() ![]() | In a CDE window, an event callback that is called when the window receives presence in the current workspace: that is, when the presence of a window is changed to include the current workspace or when the current workspace is changed to a workspace which includes this window from a workspace which did not include it. Cf. outofcurrentworkspace. See the caveats for deiconized in the callback section. Ignored outside CDE. | |
index | ![]() ![]() ![]() ![]() | A vector of indices of the rows that have been chosen (when refer is nonzero) since the object was bound or index was reset; sorted (formerly, in the order of selection). If selectionmode is `single, index is É0 and can't be set; cf. selected for the index of the selected row. | É0 |
insertabove | ![]() ![]() ![]() ![]() | Controls the action when a user presses Shift-Meta-Insert or, on IBM keyboards, Shift-Alt-Insert. The default action is to insert a new row above the selected one. Set insertabove to 0 to turn off this key combination, and 1 to get the default action. | 0 |
insertbelow | ![]() ![]() ![]() ![]() | Controls the action when a user presses Meta-Insert or, on IBM keyboards, Alt-Insert. The default action is to insert a new row below the selected one. Set insertbelow to 0 to turn off this key combination, and 1 to get the default action. | 0 |
is | ![]() ![]() ![]() | Controls the action when the object is bound to a display class. |
Attribute | Keys (POINT TO KEY FOR INFO) |
Description | Default |
---|---|---|---|
justify | ![]() ![]() ![]() | Justify the text in the title area. Settings `left, `right, `top, `bottom, 'l', 'r', 't', and 'b' are cumulative, to give all nine possible positions, unless settings begin with a dot, and several symbols or several characters can be included in one setting. Set to Null to restore the default position, centered both ways. has returns the character vector form. | Null (centered) |
key | ![]() ![]() ![]() | Controls the action whenever a key is pressed. | |
keysym | ![]() ![]() ![]() | The value represents the latest key press. | |
l | ![]() | If 1, left justify this object in its layout cell. | 0 |
label | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | The text in the label areas.
For a display class for slotfillers, the value can be a single character vector or symbol that applies to every label, or a vector of character vectors or symbols that are used cyclically - in the manner of Reshape - to label each slot individually. A character matrix m can also be used, and it is treated as if it were <@1 m. The values do not replace the symbolic indices of the underlying slotfiller object. For matrix, a single value can given, or a vector that applies to all labels, or a nested vector of length three, whose items apply to corner, row and column labels, respectively, in the manner just described. Column labels can have more than one row (see collabelrows); these labels can be specified as nested vectors of character vectors, or character matrices.
| For a class for slotfillers: the symbolic indices. For a matrix: |
labelfg | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | The color of the text in the label areas. For a display class for slotfillers, this attribute can be given a vector of values that apply cyclically to the label areas. For matrix, a single value can be given, or a nested vector of three items, each a scalar or vector, that apply to the corner label, the row labels, and the column labels, respectively. For (gauges and) scales, the foreground color for the scale label.
| `black |
labelfont | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | The font in which the text in the label areas is type set. This attribute applies
in the same manner as labelfg (above). For (gauges and) scales, the font in which the scale label appears.
| kaplgallant. If null, for matrix use font attribute. |
labelinc | ![]() | The increment between labels on the scale. A value of 0 means that s is to select an appropriate increment. | 0 |
label justify | ![]() | The justification of the scale label. One of `left, `right, `bottom, `top, `none. | h: `bottom; v: `left. |
labelout | ![]() ![]() | A format specification for the scale labels. If not functional, it is one of the forms shown in the next table. | `float |
leader | ![]() ![]() | The leader of this object for iconification (when the leader is iconified, this object is removed from the screen). | |
leading | ![]() | Default leading for reports: vertical spacing in pixels. | |
left | ![]() ![]() | The distance from the left side of the graph window to the rule of the y axis (visible or not), as a percentage of the window width. | 0 |
left margin | ![]() | The left margin of the report, in inches. | 1 |
leftto | ![]() | Object to which Shift-left-arrow moves keyboard focus. Connected to arrowlist. [Future use] | Null |
legend | ![]() ![]() | Position of the legend on the graph; e.g., `tl for top
left. Includes settings for outside the graph area. | `tl |
![]() ![]() ![]() | The text in the legend that identifies this trace. | Null (varname[:n]) | |
legendbg |
![]() ![]() |
Color of rectangle containing legend; follows bg if not set. | Null (grey) |
legendfg |
![]() ![]() |
The color of the text naming the traces in the legend. | Null (black) |
legend font |
![]() ![]() |
The font in which the legend text is type set. | lucidasans typewriter- 10 |
legendhl thickness | ![]() ![]() | The width in pixels of the legend highlight area. | 1 |
legend shadow thickness |
![]() ![]() |
The width in pixels of the shadow area around the legend area, if present. | 1 |
legend style |
![]() ![]() |
Display the legend vertically, horizontally, horizontally with the last trace values, or not at all, using `ver, `hor, `lastvalue, `none. | `ver |
line | ![]() | A k by 4 matrix of line coordinates. Each row represents a line with the format (r, c , nr, nc). Vertical lines should have nc equal 0 and horizontal lines should have nr equal 0. If both nr and nc are nonzero a vertical line is drawn, as if nc were 0. A vertical line begins at the top center of the character whose row and column indices in the page variable are r and c, respectively, and extends downward to the bottom center of the character nr rows below. A horizontal line starts at the left center and extends to the right center of the character nc columns to the right.
Line settings are not cumulative. Each setting of this attribute removes previous settings. | |
linecolor | ![]() ![]() ![]() ![]() | The color of line graphs. | from s.LINE COLORS |
linestyle | ![]() ![]() ![]() | The style of line graphs, e.g., solid or dashed. | from s.LINE STYLES |
linewidth | ![]() ![]() ![]() | The width in pixels of line graphs. | 0 (thinnest) |
![]() | The percent of the character width to be used to draw the lines specified by the line attribute. | 10 (%). | |
literal | ![]() ![]() | If 1, display character values in single quotes; if 0, don't. | 0 |
lock position | ![]() ![]() ![]() ![]() | If 1, do not reposition the children in this object when some other children are removed (e.g., freed) or unmapped. | |
locksize | ![]() ![]() ![]() ![]() | If 1, do not resize the layout when some children are removed (e.g., freed) or unmapped. | |
lower | ![]() ![]() ![]() | Specify this attribute to send this object to the back of the visible windows. |
Attribute | Keys (POINT TO KEY FOR INFO) |
Description | Default |
---|---|---|---|
majortick size | ![]() | The length in pixels of the major ticks on the scale. | 10 |
mapped | ![]() ![]() | The value is 1 if this object is mapped (to the screen), and 0 if unmapped. There are two cases:
| |
margin | ![]() ![]() | Pixel width around text. | |
margin height | ![]() | The top and bottom margins of an object in its page, in pixels. | 4 |
margins | ![]() ![]() | Use to set all four margins to the same value. | |
margin width | ![]() | The left and right margins of an object in its page, in pixels. | 4 |
max | ![]() | The maximum graphically displayed value. It is possible for it to be less than the value label. | 100 |
maxtitle | ![]() | The label that is shown for max. If null, there is no label and no space allowance for a label. | Null |
maxtitlefg | ![]() | The color in which maxtitle appears. | black |
maxtitle font | ![]() | The font in which maxtitle appears. | lucidasanstype writer-bold-12 |
maxtitle justify | ![]() | The justification for maxtitle. One of `none (no maxtitle), `top, `bottom (meaningful for hG, hS), `left, `right (meaningful for vG, vS), `center. | `center |
min | ![]() | The minimum graphically displayed value. It is possible for it to be greater than the value label. | 0 |
minortick count | ![]() | The number of minor ticks between major ticks on the scale. | 1 |
minortick size | ![]() | The length in pixels of the minor ticks on the scale. | 6 |
mintitle | ![]() | The same as maxtitle, but for min. | Null |
mintitlefg | ![]() | The same as maxtitlefg, but for min. | black |
mintitle font | ![]() | The same as maxtitlefont, but for min. | lucidasanstype writer-bold-12 |
mintitle justify | ![]() | The same as maxtitlefg, but for min. | `center |
mnemonics | ![]() ![]() | Keyboard accelerators for menus; a slotfiller of the same shape as the
menu variable. The accelerator is the first letter of the symbolic index; the values are
ignored. If several buttons at the same level are given the same accelerator, it is underlined in all of them but that key affects only the first of those buttons. Note that the default for accelerators when s.MENUDEFAULTMNEMONIC is 1 (menu variable initials) does not address this potential problem; where duplicate initials exist, mnemonics must be set specifically to provide a full set of accelerators. | 2Ò<nÒ() |
mode | ![]() ![]() | Set up interactive entry (`addtrace) or set up text entry at `coordinate (`addtexttrace), or terminate entry, like Enter or double click (`normal). | |
movelimit | ![]() ![]() ![]() | Specify whether the x coordinate (`x) or y coordinate (`y) or neither (`none) remains fixed when the pointer is used to move a trace point. | `x |
Attribute | Keys (POINT TO KEY FOR INFO) |
Description | Default |
---|---|---|---|
na | ![]() ![]() ![]() ![]() ![]() ![]() | The value used for NA in the object, e.g., when new rows or cells are inserted. Cf. blank, and s.NA and t.NA. | (©x)Øs.NA for variable x. |
naturalsize | ![]() ![]() ![]() | The number of visible rows and columns may change with changes in the size of an object or its column widths. Specify naturalsize to make the number of visible rows and columns the same as when it was first mapped - or, for a container, to do so for its contained objects. At present, at least, setting naturalsize also sets firstrow and firstcol to zero. | |
newshow | ![]() ![]() ![]() ![]() | For an existing container: if 1, a reparented child (see reparent) is always reshown and an unbound variable is shown; if 0, a reparented child is reshown only if mapped and an unbound variable is not shown; if Null, use the value of s.AUTONEWSHOW. | 0 |
newspaper column | ![]() | Number of columns in which the table is arranged on the report page (allows a narrow table to fill a page better). | 1 |
nodebg | ![]() | The background color of the nodes. | `violetred |
nodefg | ![]() | The foreground color of the nodes. | `yellow |
notify | ![]() ![]() | Furnishes a callback function for a notify event. See "Accessing the Primary Selection Buffer". | |
orientation | ![]() ![]() ![]() | Notebook (orientation on page) and tree: `horizontal
or `vertical. Report (orientation of report on paper): `landscape or `portrait. | `horizontal or `landscape |
out | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | Specifies the format in which data appears in a display.
The value can be a valid left argument to î (Format) or _fmt, in which case the data are formatted according to the rules of those functions. In addition, the value can be one of those in the "out Attribute Format Samples" table. Also see the _sfmt function. If the object is a slotfiller, individual formats can be given, as in (`out;(fmt1;fmt2;...;fmtn)). If the value of this attribute is a character matrix and the data to be displayed are valid row indices of the matrix, then each data element is replaced in the display by the text of the row it indexes. | out x:{ 1Õîx} for numeric; out x:x for character; out x:{ s.box{x}} otherwise. Sensitive to the blank attribute. |
outofcurrent workspace | ![]() ![]() | In a CDE window, an event callback that is called when the window loses presence in the current workspace: that is, when the presence of a window is changed to exclude the current workspace or when the current workspace is changed to a workspace which does not include this window from a workspace which included it. Cf. incurrentworkspace. See the caveats for deiconized in the callback section. Ignored outside CDE. | |
outputmode | ![]() | `ps: PostScript; `eps: Encapsulated PostScript; `ppm: Portable Pixmap. | `ps |
outputstyle | ![]() | `columnmajor, `rowmajor - report page
arrangement. `aligned, `noheadings - for ASCII tables. | `rowmajor |
Attribute | Keys (POINT TO KEY FOR INFO) |
Description | Default |
---|---|---|---|
pagebreakcb | ![]() ![]() | Function and optional static data for page breaks. | |
page breakon | ![]() | When set to 1, a page break is inserted after a column break. | 0 |
page changecb | ![]() ![]() | Callback when the current page is changed by a user. | Null (none) |
pagecontrol | ![]() | Vector listing pages to be printed. | Null (all) |
pagecount | ![]() ![]() | Number of pages printed so far. | |
pagecount total | ![]() ![]() | Total number of pages in the whole report. | |
pageinc | ![]() | The amount of the increase in value when PageUp is pressed and decrease when PageDown is pressed. Accepted for gauges, but meaningful only for scales. | 10 |
page numbering | ![]() | Print page numbers (1) or not (0). | 1 |
page numbers | ![]() | Vector of numbers: i-th element is page number of i-th page. | Null (i for i) |
pagenumber text | ![]() | Vector or nested vector of text to be printed with page numbers. | |
page selection | ![]() ![]() ![]() ![]() | If 1, when the object is a child of a notebook, its page can be selected; if 0, its page cannot be selected and its pagetitle (on the tab) is lightened. If its page is already selected when its pageselection attribute is set to 0, the page remains displayed (but its pagetitle is lightened). | Null (1; s.of says 1 when in notebook and null when not). |
pagesize | ![]() | Page size: one of `legal (8.5x14"); `letter or `a (both 8.5x11"); `b (11x17"); `a4 (210x279mm); or `b5 (182x257mm). May not work on non-HP printers. | `letter |
pagetitle | ![]() ![]() ![]() ![]() | The title to be shown on the notebook tab for an object that is a child of a notebook. | Null (the title, which itself has the variable name as default). |
parent | ![]() ![]() | The object whose variable explicitly contains this object. Top-level objects are their own parents. Inclusion in a report is ignored - a report object cannot be a parent -, and the parent attribute is not defined for report objects. | |
pieangle | ![]() | If pieprimaryslicealign is `none, pieangle gives the orientation of the primary slice of a pie chart in counterclockwise degrees from the three o'clock position. | 0 |
pie aspectratio | ![]() | The extent to which a pie chart is tilted towards the viewer, ranging from 0.0 to 1.0. 1.0 is a top view, or flat pie. | 0.6 |
pie depthfactor | ![]() | The maximum height of the pie in a pie chart, as a fraction of the standard depth factor. Cf. pieprofiles. | 1.0 |
pie legendalign | ![]() | Where the legend for each slice of a pie chart is placed. Values are null, `none, `inside, `outside, `left, `right, `top, `center, and `bottom. The last five control placement with regard to values and percentages and will be ignored if not consistent with the values of pievaluealign and piepercentalign. Several values may be concatenated, as in `inside`top`left. The color is controlled by the trace's titlefg attribute. | `center |
pie offsetmargin | ![]() | The margin around pie charts, as a fraction of the available space. The value ranges between 0 (inclusive) and 1 (exclusive). 0 makes pie charts as large as possible in the graph. 0.99 makes them dots. Values close to 1 cause calculation overflows, which appear as A+ domain errors. | Approx 0.3 |
pieoffsets | ![]() | The extent to which each slice is separated (pulled out) from the center of a pie chart. Values between 0.0 and 1.0 (inclusive) are treated as fractions of the pie's radius. Values greater than 1.0 and equal to or less than 100.0 are treated as percentages of the pie's radius. The value or values given are used cyclically for the slices. | 0 |
pie percentalign | ![]() | Where to place the display of the percentage that each slice is of a pie. Values are null, `none, `inside, `outside, `left, `right, `top, `center, and `bottom. The last five control placement with regard to values and legends and and will be ignored if not consistent with the values of pievaluealign and pielegendalign. Several values may be concatenated, as in `inside`top`left. The color is controlled by the trace's titlefg attribute. | Null |
pie primaryslice | ![]() | The trace index of the slice to be considered the "primary" slice of a pie chart, the slice whose display is controlled by pieprimaryslicealign or pieangle. The value -1 means that the largest slice will be considered the primary slice. For a brief time, called primaryslice. | -1 |
pieprimary slice align | ![]() | Where to place the primary slice of a pie chart (by rotating the pie). The possible values are null, `none (see pieangle), `left, `right, `top, `bottom. For a brief time, called primaryslicealign. | Null (`top) |
pieprofiles | ![]() | The height of each slice of a pie, as compared to the maximum height of the pie. Values between 0.0 and 1.0 (inclusive) are treated as fractions of the pie's maximum height. Values greater than 1.0 and equal to or less than 100.0 are treated as percentages of the pie's maximum height. The value or values given are used cyclically for the slices. | 1.0 |
pie valuealign | ![]() | Where to place the display of the value of each slice of a pie chart. Values are null, `none, `inside, `outside, `left, `right, `top, `center, and `bottom. The last five control placement with regard to percentages and legends and will be ignored if not consistent with the values of piepercentalign and pielegendalign. Several values may be concatenated, as in `inside`top`left. The format of the value display is controlled by the out attribute, and the color is controlled by the trace's titlefg attribute. | Null |
pin | ![]() ![]() | If 1 and this object is a popup window, the window is pinned; if 0, it is unpinned. | 0 if a popup |
position | ![]() ![]() ![]() ![]() | Applies to simple vector layouts unless s.AUTOBUILD is 1
and the objects in the layout already appear on the screen. If 1, the layout will be in the default vertical form; if 0, all its children have their at attribute equal to 0 0 1 1, so that they overlap; if Null, use the value of s.AUTOPOSITION. Note: this attribute must be set before the layout, lout, say, is built: i.e., start with loutû(), set the attribute value, and then set lout to its correct value. | 1 |
preset | ![]() ![]() | Specify a preset callback on this object. | |
primary | ![]() | Set this attribute in order to specify the primary selection buffer, and reference it to read that buffer. See "Accessing the Primary Selection Buffer". | |
primaryslice | ![]() | Briefly called this, but now called pieprimaryslice. | |
primaryslice align | ![]() | Briefly called this, but now called pieprimaryslicealign. | |
![]() ![]() | Specify this attribute to "print" the object in a file. If running in batch mode, not in Emacs, allow a slight delay between mapping a file and printing it, to avoid a race condition: for example, if a legend is specified for a graph and the graph is printed immediately, the legend may not appear in the print file. | ||
printable | ![]() ![]() | If 1, printable by the opt gadget. See /aplus/lib/s/ If Null, use s.AUTOPRINTABLE. | 1 |
printbottom | ![]() | The bottom page margin, in inches. | 1 |
print defaultfont | ![]() | The printer font used when the display font is unavailable. | courier |
printdis bottom margin | ![]() | Disclaimer offset from bottom edge of paper, whether in portrait or landscape orientation. | .27 in. |
printdisfile | ![]() | Path and file name of an ASCII text file. Spacing between words is honored and newlines are ignored. | none |
printdisfont | ![]() | The font in which to print the disclaimer. | times- roman-6 |
printdis left margin | ![]() | Disclaimer offset from left edge of paper, whether in portrait or landscape orientation. | .27 in. |
printdis orientation | ![]() | Controls the orientation of the disclaimer: same as object if `none or printdisstyle is `append; else `portrait or `landscape regardless of object orientation. | `none |
printdis right margin | ![]() | Disclaimer offset from right edge of paper, whether in portrait or landscape orientation. | .27 in. |
printdis rulewidth | ![]() | The width of the disclaimer rules. See printdisstyle, below. | 0 (very thin) |
printdis style | ![]() | Governs printed disclaimer: `none; `text only; text in `box; text with `rule above and below; text below `toprule; or text `appended to top-level window (scrollbars cause offset in both directions by their width). | `none |
printdistop margin | ![]() | Minimum distance between disclaimer text and bottom of the object being printed. Maximum setting is one inch. | .27 in. |
printfile | ![]() | Name of the file to receive the printed object. Set printfile to null to restore the default. Use the pageview or ghostview command to show print.ps on a display screen. | print.ps |
printleft | ![]() | The left page margin, in inches. | 1 |
printmode | ![]() | Rendition of the object:
`mono - black and white; `color - color on a color printer, grayscale on others; `reverse - reverse black and white; `colorfg - white background and true foreground colors (i.e., colors set with fg attributes) on a color printer, variable shading on a noncolor printer. | `mono |
print orientation | ![]() | `portrait or `landscape (rotated 90 degrees). | `landscape |
printoutput mode | ![]() |
`ps for Postscript. `eps for encapsulated Postscript and `ppm for portable pixmap; in these modes, printing the disclaimer is disabled, and if printfile is of the form fn.ps the file that receives the printed object is fn.eps or fn.ppm, respectively. A ppm file can be converted to a gif file using the Unix command ppmtogif, and Mosaic and Netscape can display gif files directly, as image references in html files. | `ps |
printright | ![]() | The right page margin, in inches. | 1 |
printsize | ![]() | Page size, one of: `legal (8.5x14"); `letter or `a (both 8.5x11"); `b (11x17"); `a4 (210x279mm); or `b5 (182x257mm). May not work on non-HP printers. | `letter |
printstyle | ![]() | Placement on the paper. One or more of `left, `right, `top, `bottom, `center, and `none. | `center |
printtop | ![]() | The top page margin, in inches. | 1 |
protect | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | If 1, the values in this object cannot be edited (in the case of a graph trace, a
point can't be dragged to a new position); an attempt to do so will elicit a beep.
For array, check, page, slot, and tableField objects, this attribute can be given a list of values, which is used cyclically - in the manner of the A+ primitive function Reshape - to protect each cell, or value area, individually. A table can be protected entirely or not at all; if it is protected, then so are all its fields, independent of their individual protect settings; see protected, immediately below. Note that the setting of this attribute has no effect on behavior controlled by the insertabove, insertbelow, select and delete attributes. | 0 |
protected | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | If 1, protection, as defined by the protect attribute, is on for this object. This attribute is most useful for tableFields because the protect setting for the table overrides the settings on the individual tableFields. |
Attribute | Keys (POINT TO KEY FOR INFO) |
Description | Default |
---|---|---|---|
r | ![]() | If 1, right justify this object in its layout cell. | 0 |
R | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | If 1, make all virtual rows of this object the same size. | |
raise | ![]() ![]() ![]() | Specify this attribute to bring this object to the front. | |
rband | ![]() ![]() ![]() ![]() | The action taken when a rubberband box is created. If rband is 0, none. If 1, the
default.
When a rubberband box is created, the rbandbox attribute is set no matter what the setting of rband, and even for boxes whose number of rows and columns is 0 0. | Draw outline and append new rbandbox setting to box, unless 0 0 size. |
rbandbox | ![]() ![]() ![]() | (row, col, #rows, #cols) of the most recent rubberband box. | 0 0 0 0 |
realize | ![]() ![]() ![]() | Specify this attribute to completely prepare this object for showing. Then when this layout object is shown, it will appear all at once, and not in a staggered fashion. | |
recursively | ![]() ![]() ![]() ![]() ![]() ![]() | Propagates an attribute value to the object and all its descendents;
the value of recursively is an attribute-value pair, as in `v has (`recursively; (`attr;val)) which is tantamount to (`v,Ø`descendents of `v) has¡ <(`attr;val) | |
refer | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | "Double click" left mouse button in a cell. The default action is to highlight the referred row. See index. Set refer to 0 to turn off the left mouse button, and 1 to get the default behavior. Press the left mouse button on a referred row to remove the reference. | 0 |
referpoint | ![]() ![]() ![]() | This action controls a referpoint event. Note, for coincident points: trace search order is the same as the drawing order. | |
refresh | ![]() ![]() ![]() | Refresh the visual appearance of this object to reflect recent settings of display related attributes such as fg and out. | |
reparent | ![]() ![]() ![]() ![]() | If 1, a child removed from the container will become a top-level object; if 0, it is freed; if Null, use the value of s.AUTOREPARENT. | Null (1) |
report | ![]() ![]() | Print all of the object, not just what is shown on the screen, perhaps on several pages. | |
reportfont | ![]() ![]() ![]() ![]() ![]() | Font for report. If it is not set on tableField, the value for table is used. | |
report headingfont | ![]() ![]() ![]() ![]() | Font for column heading in report. If it is not set on tableField, the value for table is used. | |
report totalfont | ![]() | The font in which the totals (if shown) appear. | |
reporttotal leading | ![]() | The vertical space, in points, around totals, if shown. | 2 |
report totalon | ![]() | Whether totals are shown in reports (1) or not (0). | 0 |
report totalstyle | ![]() | One or more of `left `right `top `bottom. | `left |
request | ![]() ![]() ![]() | Specify this attribute to trigger a subsequent notify event. See "Accessing the Primary Selection Buffer". | |
reshow | ![]() ![]() ![]() ![]() | If 1, a reparented child (see reparent) is reshown if it was shown in its
previous parent; if 0, it is not; if Null, use the value of s.AUTORESHOW. | Null (0) |
resize | ![]() ![]() ![]() | Constrains resizing the object in a layout, and controls its position within its
allotted layout area. Each setting (character string or symbol) is the total constraint if
it contains a period; otherwise it is additional to previous settings.
Set to Null to get back to the default setting, and to '' or '.' to eliminate all constraints. Setting h, H, w, or W to 1 (but not to 0) sets resize; setting resize sets these four attributes. | button, label, scalar, check, radio, and slot: 'hH'
(or `hH); all others: ''. |
resizeable | ![]() | If set to 1, this object can be resized interactively by a viewer; if 0, it cannot. This attribute must be set before this object is mapped. | |
respace | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | If respace is 1, the space attribute value is increased if it
is less than the length of the result of the default out
function; if 0, it is not; if Null, use the value of s.AUTORESPACE. | Null (0) |
right | ![]() ![]() | Distance from the right side of the graph window to the Y-axis rule (visible or not), as a percentage of window width. | 0 |
right margin | ![]() | The right margin of the report, in inches. | 1 |
rightto | ![]() | Object to which Shift-right-arrow moves keyboard focus. Connected to arrowlist. [Future use] | Null |
row | ![]() ![]() ![]() ![]() | The row index of the selected cell. The value can be -1 to indicate that no row or cell is selected. Setting this value causes the selected row to appear in the display, and, if the col attribute is set to a valid column index, the selected cell at position (row, col) to be highlighted. | -1 |
rowbg | ![]() ![]() ![]() ![]() | The background color of the selected row. The selected cell is always in the selected row; the value of the selectbg attribute is used in place of the rowbg attribute for this cell. | lightsteelblue3 |
rowcontrol | ![]() | Vector of table rows to be shown on page. | |
rowindex | ![]() | A vector of indices of the selected row labels when the selectrow attribute is 1, in the order of selection. | É0 |
row indexbg | ![]() | The background color of the indexed row labels. | medium aquamarine |
row pagespan | ![]() | Number of pages that the table rows are to span. | 0 |
rows | ![]() ![]() ![]() ![]() ![]() | The number of visible rows in the display of this object. | at most 5; for text, 5. |
rowsep | ![]() ![]() ![]() ![]() | If n, row separators appear every n rows. 0: no separators. | 1 |
rule | ![]() ![]() | Specify which axis rules appear. | `std |
rulewidth | ![]() ![]() | The width of the axes rules and tick marks, in pixels. | 0 |
Attribute | Keys (POINT TO KEY FOR INFO) |
Description | Default |
---|---|---|---|
save | ![]() ![]() | If 1, the value of the underlying character vector is updated to match the text
that appears on the screen (or that can be made to appear with the scrollbars) whenever
the user presses the Control-s key combination. If save is 0, pressing Control-s has no effect. | 1 |
scalefont | ![]() |
Whether or not to scale the table font when row or column constraints exceed the page size. If the font is not scaled, the exceeded constraints are ignored. | 1 |
scalefontcb | ![]() ![]() | Function and optional static data for variable-type callback when fonts are scaled. | |
script | ![]() ![]() ![]() | If 1, the s definition of this object will appear in the result of
s.script{}; if 0, it will not appear; if Null, use the value of s.AUTOSCRIPT. | Null (1) |
scrollbg | ![]() ![]() ![]() ![]() ![]() | If one element, the background color of any scrollbars on this object; if two, the vertical, horizontal scrollbar colors. Also see bg. | grey, grey |
scrollsize | ![]() ![]() ![]() ![]() ![]() | The height in pixels of any scrollbars on this object. | 15 |
select | ![]() ![]() ![]() ![]() ![]() ![]() ![]() | Function and static data for an event callback triggered by a left mouse button click on a value area, movement from one field to another by an arrow key, or a deletion that deletes the last row (changing the row attribute). | Select the cell holding the pointer. |
selectable | ![]() ![]() ![]() | If 1, refer events are active for this line or text trace; if 0, they are not. For selectable to be nonzero, the trace's trace set must have exactly two columns (i.e., just one trace in the set, with x coordinates explicitly given). | 1 if the trace is user created; 0 otherwise. |
selectbg | ![]() ![]() ![]() ![]() | The background color of a selected cell. | grey |
selectcol | ![]() ![]() ![]() | This action controls a select column event. | 0 |
select corner | ![]() ![]() ![]() | This action controls a select corner event. | 0 |
select distance | ![]() ![]() | The maximum distance in pixels between the pointer and a trace point in order that the point be selected for moving. | 10 |
selected | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | Row and column indices or symbolic index of selected cell or trace point; for a
graph, the selected trace set object. Also for tree. | |
selected field | ![]() | The value is a pair consisting of the row index and the tableField name (as a symbol) of the selected cell. A row index of -1 means none selected. | (-1;x), x being the object in the leftmost column. |
selected nodebg | ![]() | The background color of the currently selected node. Changes when nodefg is changed if the two are alike. | `nodefg |
selected nodefg | ![]() | The foreground color of the currently selected node. Changes when nodebg is changed if the two are alike. | `nodebg |
selected pagebg | ![]() | The background color of the currently selected page. | `grey |
selected pagefg | ![]() | The foreground color of the currently selected page. | `black |
select field | ![]() ![]() ![]() | Mouse button event on the title area of a field. The default action is to select the field whose title area holds the pointer. The selected cell becomes the one at the intersection of the selected row and selected field. | See Description. |
selection mode | ![]() ![]() ![]() ![]() ![]() | Controls whether only one row can be selected at a time (`single) or several (`multiple). When changed to `single, the index attribute is set to É0 and all rows but the one (if any) indicated in the selected attribute are "deselected"; when changed to `multiple, index is set to the row (if any) indicated in selected. | `multiple for array and view; `single for table. |
selectrow | ![]() ![]() ![]() | This action controls a select row event. | 0 |
sensitive | ![]() | If 0, all user interactions with this object and its descendents are blocked. | 1 |
set | ![]() ![]() | Specify a set callback on this object. | |
setcol | ![]() ![]() ![]() ![]() ![]() | Callback has been disabled; use the select callback instead. Here is the definition anyway: If 0 (the default), no callback when col is set. If 1, when a column is selected by user or program, but not by a setcol callback, the default callback is executed (see next column). If (f;s), when a column is selected by user or program, but not by a setcol callback, f{s;c;v} is called. | Set col to the same value in the objects named in hscrollwith. |
setfirstcol | ![]() ![]() ![]() ![]() ![]() | If 0 (the default),
no callback when firstcol is set. If 1, when firstcol is set by user or program, but not by a setfirstcol callback, the default callback is executed (see next column). If (f;s), when firstcol is set by user or program, but not by a setfirstcol callback, f{s;c;v} is called. Note that a setfirstcol callback can be triggered when firstcol is set as a result of the selection (by program) of a column which is not currently being shown. | Set firstcol to the same value in the objects named in hscrollwith. |
setfirstrow | ![]() ![]() ![]() ![]() ![]() | Like setfirstcol, but for vertical scrolling and vscrollwith. | Like setfirstcol |
setrow | ![]() ![]() ![]() ![]() ![]() | Like setcol, but for row selection and vscrollwith. Callback has been disabled; use the select callback instead. | Like setcol |
settings | ![]() ![]() | (`settings;v) of `object is, for a symbol scalar or vector v, a slotfiller holding, generally speaking, the attributes and values of the attributes named in v for `object that have nondefault values; if v is absent, as in `settings of `object, the result is a slotfiller holding, generally speaking, the attributes and values of all attributes for `object that have nondefault values. | |
shadow thickness | ![]() ![]() | The width in pixels of the shadow area around this object. | 0; 2 for graph. |
shell | ![]() ![]() | The top-level object containing this object. | |
shelltitle | ![]() | The title of this object in the window manager's title area. The default is: for the first top-level object shown, or the object specified in s.WS, either the contents of s.WSNAME, or if _argv is not empty, 0Ø_argv; for all others, the name of the object. | See Description. |
show | ![]() ![]() | If 1, show this object; if 0, hide it. I.e., show and hide a top-level object on the screen, and any other object in its container; see the show and hide functions. Cf. the realize and syncshow attributes. | |
show binding | ![]() | Show a spiral binding on the notebook (1) or not (0). | 1 |
show popup | ![]() | When the right mouse button is pressed with the pointer on the notebook, show a popup menu allowing selection of a page (1), or do not respond to the button press (0). | 1 |
showtabs | ![]() | Show tabs at edges of pages of notebook (1) or not (0). | 1 |
size | ![]() ![]() ![]() ![]() ![]() ![]() | Setting size eliminates partial rows and columns. | |
sliderbg | ![]() | The color of the slider, the moving part in a gauge or scale. | grey |
slider height | ![]() | The vertical dimension in pixels of the slider, the moving part in a gauge or scale. A setting given for a vgauge is ignored. | vscale: 30; hscale and hgauge: 14. |
slider width | ![]() | The horizontal dimension in pixels of the slider, the moving part in a gauge or scale. A setting given for an hgauge is ignored. | vscale and vgauge: 14; hscale: 30. |
space | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | Width in characters of the data display. If the space originally needed to display the data, computed using the out attribute, exceeds the space attribute, then this attribute is increased to the space needed. If data are changed in an object already being displayed and the space becomes insufficient, then the display is governed by the respace and stars attributes. Setting the title or out attribute increases the space attribute if necessary to fit title or data. | depends on the data; cf. s.WP and s.DATASPACE |
stars | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | If 1, fill a cell or row with *'s when there is insufficient room for the value; if 0, truncate the value display. | 1 |
state | ![]() ![]() ![]() | A character vector holding the s definition of this object, but not the value of this variable. In a layout, only one definition is shown for any name that appears in it several times, for economy. For tableFields and graphTraces, the class does not appear in the result of state, to keep it executable. | |
stateself | ![]() ![]() ![]() | Like state, but for the object only, without recursion. | |
structure | ![]() ![]() | The value is a slotfiller object with the settings of the at attribute for all children of this object. | |
style | ![]() ![]() ![]() ![]() ![]() | The type of graphic representation for a trace set. Also, the style of a column, one or more of `left `right `top `bottom. If it is not set for a tableField, the value for its table is used, if set. | `line for a trace set. Null (`left) for tableField. |
subtitle | ![]() ![]() ![]() | The subtitle text. | |
subtitlefg | ![]() ![]() ![]() | The color in which the subtitle appears. | `axiscolor for graph. |
subtitle font | ![]() ![]() ![]() | The font in which the subtitle is type set. | lucidasans type writer- 12 for graph. |
subtitle justify | ![]() ![]() ![]() | Justify the subtitle. | `center for graph. |
suppress duplicate | ![]() | Suppress (show as blank) any tableField entry that duplicates its immediate predecessor (1) or show it (0). | 0 |
symbol | ![]() ![]() ![]() | The symbol marking the data points in a scatter trace. | `cross |
symbolsize | ![]() ![]() ![]() | The size in pixels of the symbols in a scatter trace. | 10 |
syncshow | ![]() ![]() | Like show, except that (`syncshow;1) waits, unlike (`show;1), processing X-Events until its own MapNotify event is found. Processing then continues normally. This avoids the problem that occurs when labels and views in layouts are used as progress indicators (status reports on program initialization, for instance) but are not refreshed until after the program has finished loading and finally hits the mainloop. |
Attribute | Keys (POINT TO KEY FOR INFO) |
Description | Default |
---|---|---|---|
t | ![]() | If 1, top justify this object in its layout cell. | 0 |
tabfrom | ![]() | The object preceding this object in traversal order; if this object has focus, then press Meta-Shift-Tab or, on IBM keyboards, Alt-Shift-Tab to give that object focus. | |
tablist | ![]() | Vector of objects within this object in their order of traversal; pressing Meta-Tab or, on IBM keyboards, Alt-Tab repeatedly will give focus to these objects in the stated order. Each object can appear only once in the list. | |
tabto | ![]() | The object following this object in traversal order; if this object has focus, then Meta-Tab or, on IBM keyboards, Alt-Tab to give that object focus. | |
textactivate | ![]() ![]() ![]() | The action taken when this text trace is interactively modified. | |
textfg | ![]() | Color of text trace; symbol or character string (converted to symbol by s). | `white |
textfont | ![]() | Font of text trace; symbol or character string (converted to character by s). | lucidasans type writer- 12 |
3down | ![]() ![]() | A 3down event occurs when the right mouse button is pressed. | |
3up | ![]() ![]() | A 3up event occurs when the right mouse button is released. | |
title | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | The text in the title area of this object. The value can be: for one row, a character vector or scalar, or a symbol; for one or more rows, a character matrix, a nested vector of character vectors or scalars, or a simple symbol vector. There are various other possibilities, whose acceptance and interpretation depend upon the display class involved; avoid them! For graphTrace, meaningful for text traces only. | See "Default and Coincident Titles". |
titlefg | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | The color in which the text of the title appears. For graphTrace, meaningful for text and pie traces only. A tableField inherits its value from its table, and when the value for tableField is reset to Null it uses the current value for table. | black |
titlefont | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | The font in which the title is set. For graphTrace, meaningful for text and pie traces only. A tableField inherits its value from its table, and when the value for tableField is reset to Null it uses the current value for table. | kaplgallant |
titlejustify |
![]() ![]() ![]() ![]() | Justify the title: `left `right `bottom `top `center `none. | `center |
top | ![]() ![]() | The distance from the top of the graph window to the X-axis rule (visible or not), as a percentage of the window height. | 0 |
topmargin | ![]() | The top margin of the report, in inches. | 1 |
2down | ![]() ![]() | A 2down event occurs when the middle mouse button is pressed. | |
2up | ![]() ![]() | A 2up event occurs when the middle mouse button is released. |
Attribute | Keys (POINT TO KEY FOR INFO) |
Description | Default |
---|---|---|---|
underline | ![]() ![]() | Boolean mask indicating underlined characters. | |
uniform scaling | ![]() | Scale proportionally on x and y axes (1) or not (0). | 1 |
upto | ![]() | Object to which Shift-up-arrow moves keyboard focus. Connected to arrowlist. [Future use] | Null |
valid | ![]() ![]() | 1 if the text entered in the value area matches the password for the user name in the global variable; 0 otherwise. | 0 |
validate | ![]() ![]() | The function that is called when keyboard entry is completed (by an Enter). | |
valuefg | ![]() | The color of the value label, which shows the present value of the underlying variable. | black |
valuefont | ![]() | The font of the value label, which shows the present value of the underlying variable. | lucidasans typewriter bold-12 |
value justify | ![]() | The position of the value label, which shows the present value of the underlying variable. Values: `top `bottom `left `right `center `none. The last deletes the number. | `center `top |
vcol | ![]() | See the at attribute. | |
vcols | ![]() | See the at attribute. | |
vcolspace | ![]() ![]() ![]() ![]() | Space between the virtual columns of a layout, in pixels. | Null (0) |
verify | ![]() | Most display classes require a variable to satisfy certain rank and type
restrictions.
If 0, the A+ interpreter verifies them; when a bound variable is assigned a value inappropriate to its display class, an " û: invalid" message is issued and execution is suspended. If 1, s context functions verify them; an inappropriate value elicits a more meaningful message, followed by a stop. If Null, the value of s.VERIFY is used. [Future use] | 0 |
vertical space | ![]() | The minimum distance between vertically aligned nodes, in pixels. | 5 |
vrow | ![]() | See the at attribute. | |
vrows | ![]() | See the at attribute. | |
vrow space | ![]() ![]() ![]() ![]() | Space between virtual rows of a layout, in pixels. | Null (0) |
vscroll size | ![]() ![]() ![]() ![]() | The width in pixels of a vertical scrollbar on this object. | 15 |
vscroll with | ![]() ![]() ![]() ![]() ![]() | Like hscrollwith, but vertical scrolling, setfirstrow, setrow. | 0Ò` |
w | ![]() | If 1, do not change the width of the row containing this object on resize. | 1 for vmenu |
W | ![]() | If 1, do not change the width of this object upon resize. | 1 for vmenu |
ws | ![]() ![]() ![]() ![]() | When an object is (initially) shown and s.WS is Null, if ws for the object is 1 it becomes the screen workspace and if ws is 0 it does not; when ws is Null, the value of s.AUTOWS is used for it. | Null (1) |
Attribute | Keys (POINT TO KEY FOR INFO) |
Description | Default |
---|---|---|---|
x | ![]() | The x coordinate, in pixels, of this object relative to its parent, or relative to the screen in case this is a top-level object. | 0 (upper left corner) |
X | ![]() ![]() | The x coordinate, in pixels, of this object relative to the screen. | 0 if toplevel or popup |
xaxis | ![]() ![]() ![]() | Governs whether a trace is graphed relative to the x axis (`x) or X axis (`X). | `x |
xextent | ![]() ![]() ![]() ![]() | A three-element vector from which the length, in pixels, of the x axis can be computed. Can be used to detect zooming. | |
xfg | ![]() ![]() ![]() | The color of the indicated axis, axis labels, and tick marks. | black |
xinc | ![]() ![]() ![]() | The coordinate increment between major tick marks. | 0 (s chooses) |
xlabel | ![]() ![]() ![]() ![]() | Various explicit settings of x-axis label text and tick mark positions and sizes. | |
xlabelfont | ![]() ![]() ![]() | The font in which the x-axis labels are type set. | lucida sans type writer-12 |
xlabel height | ![]() ![]() ![]() ![]() | The height in pixels of any x-axis label. | |
xlabel justify | ![]() ![]() ![]() | Justify the x-axis labels: `left, `right, `center. | `center |
xlabelout | ![]() ![]() ![]() ![]() | Controls formatting of x-axis labels. These labels may have any values (integer or not) between xmin and xmax or, if xmin is not less than xmax, any floating-point values. Like out, xlabelout takes a function, a symbol, or a character string; unlike out, it does not take a number. | |
xlabel width | ![]() ![]() ![]() ![]() | The width in pixels of a specified x-axis label. | |
xleft | ![]() ![]() ![]() | The distance from the rule of the y axis to the bounding rectangle that holds all graph traces whose xaxis setting is `x, as a percentage of the distance between the rules of the y axis and Y axis (visible or not). | 0 |
xlegend | ![]() ![]() | The x-axis coordinate of the upper left corner of the legend box (when legend is not set after xlegend is set). | 0 |
xmajor ticksize | ![]() ![]() ![]() | The length in pixels of the major tick marks on the x axis. | 10 |
xmax | ![]() ![]() ![]() | The maximum value on the x axis. For xmax to be honored, it must be greater than xmin. Setting them all to Null also causes values computed from the trace sets to be used, but these attributes are reported as having the computed values. Any zooming that the user has done on the screen can be detected in a program by the values of xmax, etc. To undo zooming (in order, for example, to ensure that a new point is shown promptly), reset xmin, xmax, ymin, and ymax to valid values. | Computed value. |
xmin | ![]() ![]() ![]() | The minimum value on the x axis. For xmin to be honored, it must be less than xmax. Can be used to undo zooming. See xmax. | like xmax |
xminor ticks | ![]() ![]() ![]() | Number of minor ticks between major ticks on the x axis. | 1 |
xminor ticksize | ![]() ![]() ![]() | The length in pixels of the minor tick marks on the x axis. | 6 |
xright | ![]() ![]() ![]() | The distance from the rule of the Y axis to the bounding rectangle that holds all graph traces whose xaxis setting is `x, as a percentage of the distance between the rules of the y axis and Y axis (visible or not). | 0 |
xs | ![]() ![]() | The horizontal size of this object, in pixels. If the object is not displayed when this attribute is set, the realize attribute for the object must have value 1. | |
xsublabel | ![]() ![]() ![]() ![]() | Various explicit settings of x-axis sublabel text and positions. | |
xsublabel justify | ![]() ![]() ![]() | Justify the x-axis sublabels: `left, `right, `center. | `center |
xsublabel out | ![]() ![]() ![]() ![]() | Controls formatting of x-axis sublabels. See xlabelout. | |
xtickstyle | ![]() ![]() ![]() | E.g., set the x-axis tick marks to point into the plot area. | `out |
xtitle | ![]() ![]() ![]() | The text of the title on the x axis. | |
xtitlefg | ![]() ![]() ![]() | The color of the text on the x-axis title. | black |
xtitlefont | ![]() ![]() ![]() | The font in which the text of the x-axis title is type set. | lucida sans type writer -12 |
xtitle justify | ![]() ![]() ![]() | Justify the x-axis title: `left, `right, `center. | `center |
y | ![]() | The y coordinate, in pixels, of this object relative to its parent, or relative to the screen in case this is a top-level object. | 0 (upper left corner) |
Y | ![]() ![]() | The y coordinate (pixels) of the object relative to the screen. | 0 if toplevel or popup |
yaxis | ![]() ![]() ![]() | Specify whether a trace is graphed relative to the y axis or Y axis. | `y |
ybottom | ![]() ![]() ![]() | The distance from the rule of the x axis to the bounding rectangle that holds all graph traces whose yaxis setting is `y, as a percentage of the distance between the rules of the x axis and X axis (visible or not). | 0 |
ylegend | ![]() ![]() | The y-axis coordinate of the upper left corner of the legend box (when legend is not set after ylegend is set). | 0 |
ymode | ![]() ![]() ![]() | Controls which way the values run on the y axis and Y axis: `ascend or `descend. | `ascend |
ys | ![]() ![]() | The vertical size of this object, in pixels. If the object is not displayed when this attribute is set, the realize attribute for the object must have value 1. | |
ytitle style | ![]() ![]() ![]() | Set the y-axis title vertically or horizontally. | `hor |
ytop | ![]() ![]() ![]() | The distance from the rule of the X axis to the bounding rectangle that holds all graph traces whose yaxis setting is `y, as a percentage of the distance between the rules of the x axis and X axis (visible or not). | 0 |
yx | ![]() | The (y,x) coordinates, in pixels, of this object relative to its parent, or relative to the screen in case this is a top-level object. | 0, 0 (upper left corner) |
YX | ![]() ![]() | The (y,x) coordinates, in pixels, of this object relative to the screen. | 0, 0 if toplevel or popup |
yxs | ![]() ![]() | The (ys,xs) size, in pixels, of this object. If the object is not displayed when this attribute is set, the realize attribute for the object must have value 1. | |
zero | ![]() ![]() | Controls whether - for which axes - zero axes appear: `none, `x, `X, `y, `Y, `xy, `xY, `Xy, or `XY. | `xy |
zerofg | ![]() ![]() | Controls the color of the zero axes. | slategray |
zerostyle | ![]() ![]() | Controls the style of the zero axes: `dot1 through `dot5, `dotdash1 through `dotdash5, `dash1 through `dash5, or `solid. | `dot1 |
zerowidth | ![]() ![]() |
Controls the width of the zero axes: 0 through 10. | 0 (very thin) |
The intraday formats in the fourth, fifth, and sixth rows of the "out
Attribute Format Samples" table take an argument in seconds and use it mod 86400, the
number of seconds in a day. For example:
Formats containing y2 are restricted to the years 1950 through
2049.
Spaces in color names are for readability and need not be included in color specifications.
Uppercase letters are not allowed.
The s-context variable
s.COLOR_NAMES lists the permitted colors.
A+ finds the closest match to a requested color
when the window-manager colormap is full.
of returns the
color that was requested, which allows the displayed color to be duplicated.
Click here for a table showing a sample of each color.
Kanji font is available on the screen, by setting the font
attribute to
The APL font for printers can be scaled, but no scalable APL screen font is available.
There are four APL screen fonts at various pixel sizes:
Where (xX) or (xXyY) or the like appears in an attribute listing, the meaning is all
attributes formed by prefixing each of the parenthesized letters to the unparenthesized
letters.
Formats for the out
Attribute
Errors in dates return 0's except that an
erroneous `y2 is set to "**", and the length
of the result returned for a bad date is the same as for a good date.
Õtûsys.ts{}
1994 10 12 13 22 19 550
`hrminsec _sfmt 60Â3 4 5#t
01:22:19pm
The formats in the last four rows of the table take an argument of the
form yyyymmdd. For each of them, another format with the same name except
that _u is appended handles the format for values given in Unix
seconds (in the epoch). Unix seconds should be used for graphs with dates that are not
contained in a single month, because the yyyymmdd form will cause the last day of one
month and the first of the next to be widely separated in the graph.
See the notes in the preceding section.
Format Example Format Example
`float [(`float;n) accepted, but
n ignored; of returns just
`float].
97.7512
`fixed or (`fixed;n) where
n is the number of decimal digits;
of always returns the latter form.
97.751250
`frac 97 601/800
`32nd 97/24
`64th 97\48
`128th 97=096
`320th 97'241
`328th 97-241
`none 97.751250
`hr 2pm
`hr24 14
`min 32
`sec 15
`hrmin 2:32pm
`hrmin24 14:32
`minsec 32:15
`hrminsec 2:32:15pm
`hrminsec24 14:32:15
`day7 Thu
`day365 291
`day31 21
`m12 10
`m Oct
`y2 93
`y4 1993
`dmy2 21/10/93
`dmy4 21/10/1993
`mdy2 10/21/93
`mdy4 10/21/1993
`mdy
Thu Oct 21, 1993 Default and Coincident Titles
Default titles are the names of the displayed global variables and are
sensitive to their contexts. Fully qualified names are used for global variables outside
the root context, except when a child object is in the same context as its parent, in
which case the name of the child will be displayed without a context name. When a
variable is reparented, if its title and qualified or unqualified name coincide, its
title is set to Null, and so the parent then decides upon the appropriate title.
(Therefore, if the title and the unqualified name coincide and the contexts of the parent
and child are different, you must set the title just after the variable is placed
in the parent, in order to avoid having the variable's context appear in its title.)
Colors
There are 292 named colors available.
Many of the following color names have the suffix "4", which means that the four colors
with suffixes "1", "2", "3", and "4" are available, in addition to the color without the
suffix. For example, azure4 means there are colors azure, azure1, azure2, azure3, and
azure4. The numbers indicate varying degrees of grayness in the color, with 1 signifying
the least gray and 4 the most. Similarly but oppositely, there is a color grey100
denoting colors grey0 through grey100, where 100 indicates the least gray (white) and 0
the most gray (black).
aquamarine4
azure4
beige
bisque4
black
blue4
brown4
burlywood4
chartreuse4
chocolate4
coral4
cornsilk4
cyan4
firebrick4
gainsboro
gold4
goldenrod4
green4
grey100
honeydew4
ivory4
khaki4
lavender
linen
magenta4
maroon4
moccasin
navy
orange4
orchid4
peru
pink4
plum4
purple4
red4
salmon4
seashell4
sienna4
snow4
tan4
thistle4
tomato4
turquoise4
violet
wheat4
white
yellow4Preferred Fonts
Since it is possible to obtain hardcopy printout for screen displays, the recommended fonts
are the standard 35 PostScript fonts and APL. In the current A+ environment all the
standard PostScript fonts can be scaled, and can therefore be used at any pixel size. To
specify one of the screen management font attributes, use the name, followed by
"-", followed by the pixel size: e.g., Courier-10. Use a character
vector, not a symbol, to specify a font with a hyphen in its name. The standard PostScript
fonts are:
avantgarde-bookoblique
avantgarde-demi
avantgarde-demioblique
bookman-demi
bookman-demiitalic
bookman-light
bookman-lightitalic
courier
courier-bold
courier-boldoblique
courier-oblique
helvetica
helvetica-bold
helvetica-boldoblique
helvetica-narrow
helvetica-narrow-bold
helvetica-narrow-boldoblique
helvetica-narrow-oblique
helvetica-oblique
newcenturyschlbk-bold
newcenturyschlbk-bolditalic
newcenturyschlbk-italic
newcenturyschlbk-roman
palatino-bold
palatino-bolditalic
palatino-italic
palatino-roman
symbol
times-bold
times-bolditalic
times-italic
times-roman
zapfchancery-mediumitalic
zapfdingbats
"-misc-fixed-medium-r-normal--14-130-75-75-c-140-jisx0208.1983-0"
and using hex codes.
The default for all font attributes is kaplgallant.
Tasks vs. Attributes
The next table classifies all the screen management attributes, except those specifically
for reports.
Some of them appear in several
categories, but, in order to keep the table to a more helpful size, generally each is
listed in only the most appropriate category, although there may be other categories that
are not inappropriate.
doc@aplusdev.org © Copyright 19952001 Morgan Stanley Dean Witter & Co. All rights reserved.