<doc>
	<legacy_id></legacy_id>
	<name>unicodePlainText</name>
	<type>property</type>

	<syntax>
		<example>set the unicodePlainText of [chunk of] field to string</example>
		<example>get the unicodePlainText of [chunk of] field</example>
		<example></example>
		<example></example>
		<example></example>
		<example></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Returns the contents of a field chunk as plain text.</summary>

	<examples>
<example><p>write the unicodePlainText of field 1 to file myTextFile</p></example>
<example><p>put word 1 to 3 of the unicodePlainText of field "lorem" into tFirstThreeWords</p></example>
<example><p></p></example>
<example><p></p></example>
<example><p></p></example>
	</examples>

	<history>
		<introduced version="4.6">Added.</introduced>
		<deprecated version="7.0">7.0</deprecated>
		<removed version=""></removed>
		<changed version="5.5">Now works at field chunk level</changed>
		<experimental version=""></experimental>
		<nonexperimental version=""></nonexperimental>
	</history>

	<objects>
		<field/>
	</objects>

	<platforms>
		<mac/>
		<windows/>
		<linux/>
	</platforms>

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

	<security>
	</security>


	<classification>
		<category>Text and Data Processing</category>
		<category></category>
		<category></category>
		<category></category>
		<category></category>
	</classification>

	<references>
		<property tag="dontWrap">dontWrap property</property>
		<property tag="formattedText">formattedText property</property>
		<property tag="unicodeFormattedText">unicodeFormattedText property</property>
		<property tag="plainText">plainText property</property>
	</references>

	<description>
	<overview>Use the <b>unicodePlainText</b> property to get the content of a field as plain text with any listStyle properties being converted appropriately into plain-text for the paragraphs the affect.</overview>

		<parameters>
		</parameters>

	<value>The <b>unicodePlainText</b> of a field is a string.</value>
	<comments><p>When you get a field's <b>unicodePlainText</b>, the field's text is converted to plain text with any listStyle property being converted appropriately into plain-text.</p><p></p><p>Any paragraphs with listStyle set are prefixed by an appropriate plain-text form of the bullet or index. The property returns text encoded in UTF-16 in host byte-order.</p><p></p><p>Deprecated: In LiveCode 7.0 the language was changed to handle unicode transparently. This means that language functionality which previously aided unicode text manipulation is no longer required. This property should not be used in new code; simply get the plainText as normal. The following are now equivalent:</p><p></p><p>get the unicodePlainText of field 1</p><p>get textEncode(the plainText of field 1, "UTF16")</p></comments>
	</description>
</doc>