unicodeText

Specifies the text in a field, represented as Unicode (double-byte characters).

# Metadata

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

# Syntax

set the unicodeText of [chunk of] field to unicodeString

# Examples

set the unicodeText of field 1 to URL "binfile:Chinese.txt"

set the unicodeText of line 4 of field 1 to mySavedText

set the unicodeText of button languages to tUnicodeLanguageList

# Description

Use the unicodeText property to set or get the contents of a field or button as UTF-16.

>*Important:* As of LiveCode 7.0 the unicodeText property has been deprecated. It will continue to work as in previous versions but should 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.

For fields, use the unicodeText property to display a unicode string in a field or retrieve the text displayed in a field as a unicode string.

For buttons, use the unicodeText 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 unicodeLabel property.

# Tags

text processing,

# See

- **keyword:** field - **property:** dragData, text, HTMLText, unicodeLabel - **function:** uniDecode, charToNum, uniEncode - **glossary:** property, Unicode