Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
flash.text.engine 

SpaceJustifier  - AS3

Пакетflash.text.engine
Классpublic final class SpaceJustifier
НаследованиеSpaceJustifier Inheritance TextJustifier Inheritance Object

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5, Flash Lite 4

Класс SpaceJustifier представляет свойства, управляющие параметрами выравнивания по ширине для строк текстового блока.

Используйте конструктор new SpaceJustifier(), чтобы создать объект SpaceJustifier, прежде чем определять его свойства. Если определить свойства объекта SpaceJustifier после его применения к TextBlock, объект TextBlock не становится недействительным.

Посмотреть примеры

Связанные элементы API



Общедоступные свойства
 СвойствоОпределено
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  letterSpacing : Boolean
Указывает, учитывать ли межбуквенные интервалы при выравнивании по ширине.
SpaceJustifier
 InheritedlineJustification : String
Задает выравнивание строк по ширине для текста в блоке.
TextJustifier
 Inheritedlocale : String
[только для чтения] Задает локаль для определения правил выравнивания по ширине для текста в блоке.
TextJustifier
  maximumSpacing : Number
Определяет максимальный интервал (как коэффициент ширины обычного пробела) между словами для использования во время выключки.
SpaceJustifier
  minimumSpacing : Number
Определяет минимальный интервал (как коэффициент ширины обычного пробела) между словами для использования во время выключки.
SpaceJustifier
  optimumSpacing : Number
Определяет оптимальный интервал (как коэффициент ширины обычного пробела) между словами для использования во время выключки.
SpaceJustifier
Общедоступные методы
 МетодОпределено
  
SpaceJustifier(locale:String = "en", lineJustification:String = "unjustified", letterSpacing:Boolean = false)
Создает объект SpaceJustifier.
SpaceJustifier
  
[переопределить] Создает клонированную копию объекта SpaceJustifier.
SpaceJustifier
 Inherited
[статические] Собирает подкласс TextJustifier, соответствующий заданной локали.
TextJustifier
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
Сведения о свойстве

letterSpacing

свойство
letterSpacing:Boolean

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5, Flash Lite 4

Указывает, учитывать ли межбуквенные интервалы при выравнивании по ширине.

Значение по умолчанию false



Реализация
    public function get letterSpacing():Boolean
    public function set letterSpacing(value:Boolean):void

maximumSpacing

свойство 
maximumSpacing:Number

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10.1, AIR 2

Определяет максимальный интервал (как коэффициент ширины обычного пробела) между словами для использования во время выключки. Если letterSpacing имеет значение true, межбуквенные интервалы будут использоваться после того, как интервалы между словами достигнут максимума. Если letterSpacing имеет значение false, пробелы между словами будут расширяться без учета ограничений.

По умолчанию используется значение 1.5



Реализация
    public function get maximumSpacing():Number
    public function set maximumSpacing(value:Number):void

Выдает
ArgumentError — Задано значение value меньше optimumSpacing.

minimumSpacing

свойство 
minimumSpacing:Number

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10.1, AIR 2

Определяет минимальный интервал (как коэффициент ширины обычного пробела) между словами для использования во время выключки.

По умолчанию используется значение 0.5



Реализация
    public function get minimumSpacing():Number
    public function set minimumSpacing(value:Number):void

Выдает
ArgumentError — Задано значение value меньше нуля или больше optimumSpacing.

optimumSpacing

свойство 
optimumSpacing:Number

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10.1, AIR 2

Определяет оптимальный интервал (как коэффициент ширины обычного пробела) между словами для использования во время выключки.

По умолчанию используется значение 1.0



Реализация
    public function get optimumSpacing():Number
    public function set optimumSpacing(value:Number):void

Выдает
ArgumentError — Задано значение value меньше minimumSpacing или больше maximumSpacing.
Сведения о конструкторе

SpaceJustifier

()Конструктор
public function SpaceJustifier(locale:String = "en", lineJustification:String = "unjustified", letterSpacing:Boolean = false)

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5, Flash Lite 4

Создает объект SpaceJustifier. Класс LineJustification содержит константы для задания типов выравнивания строк по ширине, которые можно применить.

Параметры
locale:String (default = "en") — Локаль, определяющая правила выравнивания. Значение по умолчанию равно en.
 
lineJustification:String (default = "unjustified") — Тип выравнивания строк в абзаце. Используйте константы LineJustification для этого свойства. Значение по умолчанию равно LineJustification.UNJUSTIFIED.
 
letterSpacing:Boolean (default = false) — Указывает, учитывать ли межбуквенные интервалы при выравнивании по ширине. Значение по умолчанию false.

Выдает
ArgumentError — Локаль locale имеет значение null или значение, являющееся слишком коротким, чтобы быть действительным.
 
ArgumentError — Заданная локаль lineJustification не является членом LineJustification.

Связанные элементы API

Сведения о методе

clone

()метод
override public function clone():flash.text.engine:TextJustifier

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5, Flash Lite 4

Создает клонированную копию объекта SpaceJustifier.

Возвращает
flash.text.engine:TextJustifier — Копия объекта SpaceJustifier.
SpaceJustifierExample.as

В следующем примере показано назначение интервалов между буквами и выравнивание текстового блока по ширине, кроме последней строки.
package {
    import flash.display.Sprite;
    import flash.text.engine.TextBlock;
    import flash.text.engine.TextElement;
    import flash.text.engine.TextLine;
    import flash.text.engine.ElementFormat;
    import flash.text.engine.SpaceJustifier;
    import flash.text.engine.LineJustification;
    
    public class SpaceJustifierExample extends Sprite {
        
        public function SpaceJustifierExample():void {
            var str:String = "Lorem ipsum dolor sit amet, consectetur adipisicing elit, " +
            "sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut " +
            "enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut " +
            "aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit " +
            "in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur " +
            "sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt " +
            "mollit anim id est laborum.";
            
            var format:ElementFormat = new ElementFormat(null, 12, 0xCC0000);
            var textElement:TextElement = new TextElement(str, format);
            var spaceJustifier:SpaceJustifier = new SpaceJustifier("en", LineJustification.ALL_BUT_LAST);
            spaceJustifier.letterSpacing = true;
            var textBlock:TextBlock = new TextBlock();
            textBlock.content = textElement;
            textBlock.textJustifier = spaceJustifier;
            createLines(textBlock);
        }
        
        private function createLines(textBlock:TextBlock):void {
        
            var yPos = 20;
            var textLine:TextLine = textBlock.createTextLine (null, 150);
 
            while (textLine)
            {
                addChild(textLine);
                textLine.x = 15;
                yPos += textLine.textHeight+2;
                textLine.y = yPos;
                textLine = textBlock.createTextLine(textLine, 150);
            }        
        }
    }
}




[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.