<doc>
	<legacy_id>1863</legacy_id>
	<name>unicodeText</name>
	<type>property</type>

	<syntax>
		<example>set the unicodeText of [<i>chunk</i> of] <i>field</i> to <i>unicodeString</i></example>
		<example>set the unicodeText of <i>button</i>to<i>unicodeString</i></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Specifies the text in a <keyword tag="field">field</keyword>, represented as <glossary tag="Unicode">Unicode</glossary> (double-byte characters).</summary>

	<examples>
<example>set the unicodeText of field 1 to URL binfile:Chinese.txt</example>
<example>set the unicodeText of line 4 of field 1 to mySavedText</example>
<example><p>set the unicodeText of button languages to tUnicodeLanguageList</p></example>
	</examples>

	<history>
		<introduced version="2.0">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		<changed version="7.0">Deprecated</changed>
<changed version="5.5">allows setting / getting the content of field and buttons as UTF-16</changed>
		<experimental version=""></experimental>
		<nonexperimental version=""></nonexperimental>
	</history>

	<objects>
		<field/>
		<button/>
	</objects>

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

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

	<security>
	</security>


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

	<references>
		<function tag="charToNum">charToNum Function</function>
		<function tag="uniEncode">uniEncode Function</function>
		<function tag="uniDecode">uniDecode Function</function>
		<property tag="HTMLText">HTMLText Property</property>
		<property tag="dragData">dragData Property</property>
		<property tag="text">text Property</property>
		<property tag="unicodeLabel">unicodeLabel Property</property>
	</references>

	<description>
	<overview>Use the <b>unicodeText</b> <glossary tag="property">property</glossary> to set or get the contents of a field or button as UTF-16.</overview>

		<parameters>
		</parameters>

	<value>The <b>unicodeText</b> is a UTF-16 string.</value>
	<comments><important><p>As of LiveCode 7.0 the unicodeText property has been deprecated. It will continue to work as in previous versions but shoud not be used in new code as the existing behaviour is incompatible with the new, transparent Unicode handling (the resulting value will be treated as binary data rather than text). This functions is only useful in combination with the also-deprecated uniEncode and uniDecode function.</important><p></p><p><b>Fields</b></p><p>Use the <b>unicodeText</b> property to display a unicode string in a field or retrieve the text displayed in a field as a unicode string.</p><p></p><p><b>Buttons</b></p><p>Use the <b>unicodeText</b> property to set the menu contents of a button(if it is a menu) to a unicode string. To set the label of a button to a unicode string use the <property tag="unicodeLabel">unicodeLabel</property> property.</p></comments>
	</description>
</doc>