Packageflash.text.ime
Classpublic final class CompositionAttributeRange
InheritanceCompositionAttributeRange Inheritance Object

Language version: ActionScript 3.0
Runtime version: AIR 2

The CompositionAttributeRange class represents a range of composition attributes for use with IME (input method editor) events. For example, when editing text in the IME, the text is divided by the IME into composition ranges. These composition ranges are flagged as selected (such as currently being lengthened, shortened, or edited), and/or converted (meaning the range went through the IME dictionary lookup, already).

By convention, the client should adorn these composition ranges with underlining or highlighting according to the flags.

For example:

     !converted              = thick gray underline (raw text)
     !selected && converted  = thin black underline
      selected && converted  = thick black underline

See also

flash.text.ime.IIMEClient


Public Properties
 PropertyDefined by
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
  converted : Boolean
A property defining the current clause has been processed by the IME and the clause is waiting to be accepted or confirmed by the user.
CompositionAttributeRange
 Inheritedprototype : Object
[static] A reference to the prototype object of a class or function object.
Object
  relativeEnd : int
The position of the end of the composition clause, relative to the beginning of the inline edit session.
CompositionAttributeRange
  relativeStart : int
The relative start position from the beginning of the current inline editing session.
CompositionAttributeRange
  selected : Boolean
A property defining the current composition clause is active and lengthened or shortened or edited with the IME while the neighboring clauses are not changing.
CompositionAttributeRange
Public Methods
 MethodDefined by
  
CompositionAttributeRange(relativeStart:int, relativeEnd:int, selected:Boolean, converted:Boolean)
Creates a CompositionAttributeRange object.
CompositionAttributeRange
 Inherited
Indicates whether an object has a specified property defined.
Object
 Inherited
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
 Inherited
Indicates whether the specified property exists and is enumerable.
Object
 Inherited
Sets the availability of a dynamic property for loop operations.
Object
 Inherited
Returns the string representation of this object, formatted according to locale-specific conventions.
Object
 Inherited
Returns the string representation of the specified object.
Object
 Inherited
Returns the primitive value of the specified object.
Object
Property detail
convertedproperty
public var converted:Boolean

Language version: ActionScript 3.0
Runtime version: AIR 2

A property defining the current clause has been processed by the IME and the clause is waiting to be accepted or confirmed by the user.

relativeEndproperty 
public var relativeEnd:int

Language version: ActionScript 3.0
Runtime version: AIR 2

The position of the end of the composition clause, relative to the beginning of the inline edit session. For example, 0 equals the start of the text the IME reads (however, text might exist before that position in the edit field).

relativeStartproperty 
public var relativeStart:int

Language version: ActionScript 3.0
Runtime version: AIR 2

The relative start position from the beginning of the current inline editing session. For example, 0 equals the start of the text the IME reads (however, text might exist before that position in the edit field).

selectedproperty 
public var selected:Boolean

Language version: ActionScript 3.0
Runtime version: AIR 2

A property defining the current composition clause is active and lengthened or shortened or edited with the IME while the neighboring clauses are not changing.

Constructor detail
CompositionAttributeRange()constructor
public function CompositionAttributeRange(relativeStart:int, relativeEnd:int, selected:Boolean, converted:Boolean)

Language version: ActionScript 3.0
Runtime version: AIR 2

Creates a CompositionAttributeRange object.

Parameters
relativeStart:int — The zero based index of the first character included in the character range.
 
relativeEnd:int — The zero based index of the last character included in the character range.
 
selected:Boolean — Defines the current composition clause as active or not.
 
converted:Boolean — Defines the current clause as processed by the IME and waiting for user confirmation.