<doc>
	<legacy_id>1308</legacy_id>
	<name>dontWrap</name>
	<type>property</type>

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

	<synonyms>
	</synonyms>

	<summary>Specifies whether the text in a paragraph or <keyword tag="field">field</keyword> word-wraps when it reaches the field's right edge.</summary>

	<examples>
<example>set the dontWrap of field 1 to true</example>
<example>set the dontWrap of line 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">Added support for wrapping at paragraph level</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="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="firstIndent">firstIndent Property</property>
		<property tag="rightIndent">rightIndent Property</property>
		<property tag="spaceAbove">spaceAbove Property</property>
		<property tag="spaceBelow">spaceBelow Property</property>
		<property tag="tabstops">tabstops 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="vgrid">vgrid Property</property>
		<property tag="hidden">hidden Property</property>
	</references>

	<description>
	<overview>Use the <b>dontWrap</b> property to control whether lines of text in a field wrap or not.</overview>

		<parameters>
		</parameters>

	<value>The <b>dontWrap</b> of a field is true or false.</value>
	<comments>By default, the <b>dontWrap</b> <glossary tag="property">property</glossary> of newly created <glossary tag="field">fields</glossary> is set to false.<p></p><p><b>Comments:</b></p><p>If a field's <b>dontWrap</b> <glossary tag="property">property</glossary> is false, the text in the <keyword tag="field">field</keyword> wraps to the next line automatically when it reaches the right edge of the <keyword tag="field">field</keyword>, so all the text is visible in the <glossary tag="field">field's</glossary> width.</p><p></p><p>If the <b>dontWrap</b> is true, lines that are too long to fit in the width of the <keyword tag="field">field</keyword> disappear off the right edge of the <keyword tag="field">field</keyword>. (The excess text is still in the <keyword tag="field">field</keyword>--it just can't be seen.) To edit long lines in a <keyword tag="field">field</keyword> whose <b>dontWrap</b> is true, set the field's <property tag="hScrollbar">hScrollbar</property> to true to display a horizontal scrollbar.</p><p></p><p></p><note>The <b>dontWrap</b> property is always true for any field with the <property tag="listBehavior">listBehavior property</property> set to true, setting the dontWrap to false on such a field has no affect.</note></comments>
	</description>
</doc>