tabs

Generic Function

Package: common-graphics

Arguments: standard-object

Returns or sets with setf the value of the tabs property of the argument. The value of this property is a list of distances (in pixels) from the left edge of the control. These are spacing guides for text whenever tab characters appear in a displayed string. For list controls, these values specify the location of columns when the list control displays multiple columns.

tabs is a property of the outline, dropping-outline, multi-item-list, single-item-list, multi-line-editable-text, and text-edit-pane classes.

text-edit-pane and rich-edit control arguments: when standard-object is a text-edit-pane (or a rich-edit-pane, which is a subclass of text-edit-pane), or a rich-edit control, tabs returns a list of tabstop positions, indicating to where text will move rightward wherever a tab character appears in the text. The values are specified in points, where 0 indicates the interior left edge of the text-edit-pane and 72 indicates one inch to the right (since a point is one 72nd of an inch). The values are ordered from left to right.

(setf tabs) for a text-edit-pane and for a rich-edit control establishes the set of tabstop positions for text-edit-pane, indicating to where text will move rightward wherever a tab character appears in the text. value should be a list of tabstop positions ordered from left to right and specified in points, where 0 indicates the interior left edge of the text-edit-pane (or left margin of the printed output) and 72 indicates one inch to the right (since a point is one 72nd of an inch).

If the rich-edit has its tabstop property turned off (the default), then pressing the tab key will insert a tab character into the control's text. If the tabstop property is turned on, then pressing the tab key will move the focus to the next widget, and control-semicolon must be pressed in order to insert a tab character interactively. A comtab or virtual-key-down method could be supplied to make some other keychord insert a tab-character by doing something like

(write-char #\tab rich-edit-pane)

See About Rich Text Editing in Common Graphics in cgide.htm.

Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm.

The documentation is described in introduction.htm and the index is in index.htm.

Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.

Created 2000.10.5.