vGrid

Specifies whether a field tab stops are treated as cell boundaries.

# Metadata

Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.0 Security:

# Syntax

set the vGrid [of line lineNumber] of field to {true | false}

# Examples

set the vGrid of the templateField to true

set the vGrid of line 10 to -1 of field 1 to true

# Description

Use the vGrid property to make a field behave like a spreadsheet with a grid of cells.

If the vGrid property is true, LiveCode draws a vertical line at each tab stop position in the field. The lines are drawn in the field borderColor. This property is useful for fields that are used like a spreadsheet, with each tab stop marking a column.

Any text in a column is truncated when it reaches the right edge of the column. To show the entire contents of the column, drag over the text to select it. If text at the end of a line does not have a tab following it--that is, if it's the last column in the field--it is not truncated.

If the field's tabStops property is set to empty, the vGrid lines are drawn every 32 pixels, but the text is not truncated to individual cells.

# Tags

ui,

# See

- **keyword:** field - **property:** leftIndent, borderWidth, textAlign, dontWrap, formattedText, spaceAbove, backgroundColor, hiliteColor, listBehavior, listIndent, hidden, textSize, firstIndent, listStyle, spaceBelow, tabStops, rightIndent, listDepth, hgrid, pixels, hScrollbar, borderColor, formattedWidth - **object:** field - **glossary:** property, tab stop