<doc>
	<legacy_id>2102</legacy_id>
	<name>vGrid</name>
	<type>property</type>

	<syntax>
		<example>set the vGrid [of line <i>lineNumber</i>] of <i>field</i> to {true | false}</example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Specifies whether a <glossary tag="field">field's</glossary> <glossary tag="tab stop">tab stops</glossary> are treated as cell boundaries.</summary>

	<examples>
<example>set the vGrid of the fieldTemplate to true</example>
<example>set the vGrid of line 10 to -1 of field 1 to true</example>
	</examples>

	<history>
		<introduced version="1.0">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		<changed version="5.5">Line/paragraph level</changed>
<changed version="2.0">2.0</changed>
	</history>

	<objects>
		<field/>
	</objects>

	<platforms>
		<mac/>
		<windows/>
		<linux/>
		<ios/>
		<android/>
	</platforms>

	<classes>
		<desktop/>
		<server/>
		<web/>
		<mobile/>
	</classes>

	<security>
	</security>


	<classification>
		<category>Appearance &amp; Positioning</category>
	</classification>

	<references>
		<property tag="textSize">textSize Property</property>
		<property tag="hScrollbar">hScrollbar Property</property>
		<property tag="formattedText">formattedText Property</property>
		<property tag="formattedWidth">formattedWidth Property</property>
		<property tag="listBehavior">listBehavior Property</property>
		<property tag="textAlign">textAlign Property</property>
		<property tag="listStyle">listStyle Property</property>
		<property tag="listDepth">listDepth Property</property>
		<property tag="listIndent">listIndent Property</property>
		<property tag="firstIndent">firstIndent Property</property>
		<property tag="rightIndent">rightIndent Property</property>
		<property tag="leftIndent">leftIndent Property</property>
		<property tag="spaceAbove">spaceAbove Property</property>
		<property tag="spaceBelow">spaceBelow Property</property>
		<property tag="backgroundColor">backgroundColor Property</property>
		<property tag="borderWidth">borderWidth Property</property>
		<property tag="borderColor">borderColor Property</property>
		<property tag="hgrid">hgrid Property</property>
		<property tag="hidden">hidden Property</property>
		<property tag="dontWrap">dontWrap Property</property>
		<property tag="tabStops">tabStops Property</property>
	</references>

	<description>
	<overview>Use the <b>vGrid</b> <glossary tag="property">property</glossary> to make a field behave like a spreadsheet with a grid of cells.</overview>

		<parameters>
		</parameters>

	<value>The <b>vGrid</b> of a <keyword tag="field">field</keyword> is true or false.<p></p><p>By default, the <b>vGrid</b> <glossary tag="property">property</glossary> of newly created <glossary tag="field">fields</glossary> is set to false.</p></value>
	<comments>If the  <b>vGrid</b> <glossary tag="property">property</glossary> is true, LiveCode draws a vertical line at each <glossary tag="tab stop">tab stop</glossary> position in the <keyword tag="field">field</keyword>. The lines are drawn in the <glossary tag="field">field's</glossary> <property tag="borderColor">borderColor</property>. This <glossary tag="property">property</glossary> is useful for <glossary tag="field">fields</glossary> that are used like a spreadsheet, with each <glossary tag="tab stop">tab stop</glossary> marking a column.<p></p><p>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.</p><p></p><p>If the field's <b>tabStops</b> <glossary tag="property">property</glossary> is set to empty, the <b>vGrid</b> lines are drawn every 32 <property tag="pixels">pixels</property>, but the text is not truncated to individual cells.</p><p></p><p></p><change><p>The use of the <b>borderColor</b> to draw grid lines was introduced in version 2.0. In previous versions, the grid lines were drawn in the <property tag="hiliteColor">hiliteColor</property>.</change></comments>
	</description>
</doc>