fl.controls.Button (ActionScript 3.0)

Пакет	fl.controls
Класс	public class Button
Наследование	Button LabelButton BaseButton UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object
Реализует	IFocusManagerComponent

Язык версии :

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9.0.28.0

Компонент Button представляет собой обычную прямоугольную кнопку. Компоненты Button отображают текстовую метку, значок или и то, и другое.

Компонент Button, как правило, связан с методом обработчика событий, прослушивающим событие click и выполняющим указанную задачу после отправки события click. Когда пользователь нажимает на включенную кнопку, она отправляет события click и buttonDown. Даже если кнопка не включена, она отправляет другие события, включая mouseMove, mouseOver, mouseOut, rollOver, rollOut, mouseDown и mouseUp.

Внешний вид кнопки можно изменить, связав с каждым состоянием кнопки разную обложку. Компонент Button можно также настроить так, чтобы он играл роль нажимаемой кнопки или переключателя.

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

Общедоступные свойства

Скрыть унаследованные общедоступные свойства

Показать унаследованные общедоступные свойства

	Свойство		Определено
		accessibilityProperties : AccessibilityProperties Текущие параметры специальных возможностей для данного экранного объекта.	DisplayObject
		alpha : Number Указывает значение альфа-прозрачности заданного объекта.	DisplayObject
		autoRepeat : Boolean Определяет или задает логическое значение, указывающее, отправляется ли событие buttonDown более одного раза, если кнопка мыши удерживается над компонентом.	BaseButton
		blendMode : String Значение класса BlendMode, задающее режим наложения.	DisplayObject
		blendShader : Shader [только для записи] Задает затенение, используемое при наложении переднего плана на фон.	DisplayObject
		buttonMode : Boolean Задает режим кнопки данного спрайта.	Sprite
		cacheAsBitmap : Boolean При значении true проигрыватель Flash Player кэширует внутреннее растровое представление экранного объекта.	DisplayObject
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object
		contextMenu : ContextMenu Определяет контекстное меню, связанное с данным объектом.	InteractiveObject
		doubleClickEnabled : Boolean Определяет, получает ли объект события doubleClick.	InteractiveObject
		dropTarget : DisplayObject [только для чтения] Определяет экранный объект, над которым перетаскивается спрайт, либо на котором спрайт был отпущен.	Sprite
		emphasized : Boolean Определяет или задает логическое значение, указывающее, отрисовывается ли граница вокруг компонента Button, когда кнопка не нажата.	Button
		enabled : Boolean Определяет или задает значение, указывающее, принимает ли компонент ввод данных пользователем.	BaseButton
		filters : Array Индексированный массив, который содержит все объекты filter, связанные в настоящий момент с экранным объектом.	DisplayObject
		focusEnabled : Boolean Определяет или задает логическое значение, указывающее, может ли компонент принимать фокус при щелчке пользователя.	UIComponent
		focusManager : IFocusManager Определяет или задает объект FocusManager, управляющий фокусом для этого компонента и компонентов, находящихся на том же уровне иерархии.	UIComponent
		focusRect : Object Задает отображение прямоугольной рамки индикатора фокуса для данного объекта.	InteractiveObject
		graphics : Graphics [только для чтения] Задает объект Graphics, принадлежащий данному спрайту, в котором могут выполняться команды векторного рисования.	Sprite
		height : Number Определяет или задает высоту компонента (в пикселах).	UIComponent
		hitArea : Sprite Определяет другой спрайт в качестве области щелчка для спрайта.	Sprite
		label : String Определяет или задает текстовую метку для компонента.	LabelButton
		labelPlacement : String Расположение метки относительно заданного значка.	LabelButton
		loaderInfo : LoaderInfo [только для чтения] Возвращает объект LoaderInfo, содержащий сведения о загрузке файла, к которому принадлежит этот экранный объект.	DisplayObject
		mask : DisplayObject Вызывающий экранный объект маскируется заданным объектом mask.	DisplayObject
		mouseChildren : Boolean Определяет, включен ли переход между потомками объекта с помощью мыши.	DisplayObjectContainer
		mouseEnabled : Boolean Определяет, получает ли этот объект сообщения мыши.	InteractiveObject
		mouseFocusEnabled : Boolean Определяет или задает значение, указывающее, может ли компонент принимать фокус при щелчке пользователя.	UIComponent
		mouseX : Number [только для чтения] Указывает координату x положения курсора мыши (в пикселах).	DisplayObject
		mouseY : Number [только для чтения] Указывает координату y положения курсора мыши (в пикселах).	DisplayObject
		name : String Указывает имя экземпляра DisplayObject.	DisplayObject
		numChildren : int [только для чтения] Возвращает число потомков данного объекта.	DisplayObjectContainer
		opaqueBackground : Object Определяет, является ли экранный объект непрозрачным с определенным цветом фона.	DisplayObject
		parent : DisplayObjectContainer [только для чтения] Указывает объект DisplayObjectContainer, содержащий данный экранный объект.	DisplayObject
		prototype : Object [статические] Ссылка на модель объекта класса или функции.	Object
		root : DisplayObject [только для чтения] В случае с экранным объектом в загруженном SWF-файле свойством root является самый верхний экранный объект в части структуры дерева списка отображения, представленной этим SWF-файлом.	DisplayObject
		rotation : Number Указывает поворот экземпляра DisplayObject относительно его исходной ориентации (в градусах).	DisplayObject
		rotationX : Number Обозначает поворот в градусах по оси x экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру.	DisplayObject
		rotationY : Number Обозначает поворот в градусах по оси у экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру.	DisplayObject
		rotationZ : Number Обозначает поворот в градусах по оси z экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру.	DisplayObject
		scale9Grid : Rectangle Текущая активная сетка масштабирования.	DisplayObject
		scaleX : Number Умножает текущую ширину компонента на коэффициент масштабирования.	UIComponent
		scaleY : Number Умножает текущую высоту компонента на коэффициент масштабирования.	UIComponent
		scaleZ : Number Указывает масштабирование глубины объекта (в процентах) относительно точки регистрации этого объекта.	DisplayObject
		scrollRect : Rectangle Прямоугольная область прокрутки экранного объекта.	DisplayObject
		selected : Boolean Определяет или задает логическое значение, указывающее, включена или выключена кнопка-переключатель.	LabelButton
		soundTransform : SoundTransform Управляет звуком в данном спрайте.	Sprite
		stage : Stage [только для чтения] Класс Stage экранного объекта.	DisplayObject
		tabChildren : Boolean Определяет, включен ли переход между потомками объекта с помощью клавиши Tab.	DisplayObjectContainer
		tabEnabled : Boolean Определяет, включен ли этот объект в последовательность перехода с помощью клавиши Tab.	InteractiveObject
		tabIndex : int Задает последовательность перехода между объектами в SWF-файле.	InteractiveObject
		textField : TextField Ссылка на внутреннее текстовое поле компонента.	LabelButton
		textSnapshot : TextSnapshot [только для чтения] Возвращает объект TextSnapshot для данного экземпляра DisplayObjectContainer.	DisplayObjectContainer
		toggle : Boolean Определяет или задает логическое значение, указывающее, может ли кнопка переключаться.	LabelButton
		transform : Transform Объект со свойствами, относящимися к матрице, преобразованию цвета и пиксельным границам экранного объекта.	DisplayObject
		useHandCursor : Boolean Логическое значение, определяющее, должен ли отображаться указатель "рука" при наведении указателя мыши на спрайт, в котором свойство buttonMode имеет значение true.	Sprite
		version : String = "3.0.0.15" Номер версии компонентов.	UIComponent
		visible : Boolean Определяет или задает значение, указывающее, видим ли текущий экземпляр компонента.	UIComponent
		width : Number Определяет или задает ширину компонента (в пикселах).	UIComponent
		x : Number Определяет или задает координату, представляющую положение компонента по оси X в пределах родительского контейнера.	UIComponent
		y : Number Определяет или задает координату, представляющую положение компонента по оси Y в пределах родительского контейнера.	UIComponent
		z : Number Указывает положение по оси z экземпляра DisplayObject относительно трехмерного родительского контейнера.	DisplayObject

Общедоступные методы

Скрыть унаследованные общедоступные методы

Показать унаследованные общедоступные методы

	Метод		Определено
		Button() Создает новый экземпляр компонента Button.	Button
		addChild(child:DisplayObject):DisplayObject Добавляет дочерний экземпляр DisplayObject к данному экземпляру DisplayObjectContainer.	DisplayObjectContainer
		addChildAt(child:DisplayObject, index:int):DisplayObject Добавляет дочерний экземпляр DisplayObject к данному экземпляру DisplayObjectContainer.	DisplayObjectContainer
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Регистрирует объект прослушивателя события в объекте EventDispatcher, в результате чего прослушиватель будет получать уведомления о событиях.	EventDispatcher
		areInaccessibleObjectsUnderPoint(point:Point):Boolean Показывает, могут ли ограничения безопасности привести к пропуску каких-либо экранных объектов в списке, возвращаемом в результате вызова метода DisplayObjectContainer.getObjectsUnderPoint() с заданной точкой.	DisplayObjectContainer
		clearStyle(style:String):void Удаляет свойство style для экземпляра компонента.	UIComponent
		contains(child:DisplayObject):Boolean Определяет, является ли заданный экранный объект дочерним объектом экземпляра DisplayObjectContainer или самим экземпляром.	DisplayObjectContainer
		dispatchEvent(event:Event):Boolean Передает событие в поток событий.	EventDispatcher
		drawFocus(focused:Boolean):void Отображает или скрывает индикатор фокуса этого компонента.	UIComponent
		drawNow():void Инициирует немедленную операцию отрисовки без аннулирования всех элементов (в отличие от метода invalidateNow).	UIComponent
		dynamicNewFunc1():Number	DisplayObject
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle Возвращает прямоугольник, определяющий область экранного объекта, которая относится к системе координат объекта targetCoordinateSpace.	DisplayObject
		getChildAt(index:int):DisplayObject Возвращает экземпляр дочернего экранного объекта, существующий в заданной позиции индекса.	DisplayObjectContainer
		getChildByName(name:String):DisplayObject Возвращает экземпляр дочернего экранного объекта с заданным именем.	DisplayObjectContainer
		getChildIndex(child:DisplayObject):int Возвращает позицию индекса для дочернего экземпляра DisplayObject.	DisplayObjectContainer
		getDynamicZ():Number	DisplayObject
		getFocus():InteractiveObject Возвращает объект, который в настоящее время имеет фокус.	UIComponent
		getObjectsUnderPoint(point:Point):Array Возвращает массив объектов, расположенных ниже заданной позиции и являющихся дочерними объектами любого уровня для данного экземпляра DisplayObjectContainer.	DisplayObjectContainer
		getRect(targetCoordinateSpace:DisplayObject):Rectangle Возвращает прямоугольник, определяющий границу экранного объекта по системе координат, заданной параметром targetCoordinateSpace, за исключением линий фигур.	DisplayObject
		getStyle(style:String):Object Возвращает свойство style, установленное в последовательности для поиска стилей компонента.	UIComponent
		getStyleDefinition():Object [статические] Возвращает карту стилей по умолчанию для текущего компонента.	Button
		globalToLocal(point:Point):Point Преобразует объект Point из координат рабочей области (глобальных) в координаты экранного объекта (локальные).	DisplayObject
		hasEventListener(type:String):Boolean Проверяет наличие у объекта EventDispatcher прослушивателей событий, которые зарегистрированы для получения уведомлений о событиях определенного типа.	EventDispatcher
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		hitTestObject(obj:DisplayObject):Boolean Оценивает экранный объект, чтобы определить, перекрывает ли он экранный объект obj или пересекается с ним.	DisplayObject
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean Вычисляет экранный объект, чтобы определить, перекрывает ли он точку, заданную координатами x и y, или пересекает ее.	DisplayObject
		invalidate(property:String, callLater:Boolean = true):void Помечает свойство как недопустимое и обновляет компонент в следующем кадре, если не указано иное.	UIComponent
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		localToGlobal(point:Point):Point Преобразует объект point из координат экранного объекта (локальных) в координаты рабочей области (глобальные).	DisplayObject
		mergeStyles(... list):Object [статические] Объединяет стили из нескольких классов в одном объекте.	UIComponent
		move(x:Number, y:Number):void Перемещает компонент в указанное положение в пределах его родительского компонента.	UIComponent
		newFunc1():Number	DisplayObject
		newFunc2():Number	DisplayObject
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		removeChild(child:DisplayObject):DisplayObject Удаляет заданный дочерний объект DisplayObject из списка потомков экземпляра DisplayObjectContainer.	DisplayObjectContainer
		removeChildAt(index:int):DisplayObject Удаляет дочерний DisplayObject из заданной позиции индекса в списке потомков DisplayObjectContainer.	DisplayObjectContainer
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Удаляет прослушиватель из объекта EventDispatcher.	EventDispatcher
		setChildIndex(child:DisplayObject, index:int):void Изменяет положение существующего потомка в DisplayObjectContainer.	DisplayObjectContainer
		setFocus():void Задает фокус на этот компонент.	UIComponent
		setMouseState(state:String):void Устанавливает состояние мыши с помощью сценария ActionScript.	BaseButton
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		setSize(width:Number, height:Number):void Задает указанную высоту и ширину компонента.	UIComponent
		setStyle(style:String, value:Object):void Задает свойство style для экземпляра компонента.	UIComponent
		startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void Позволяет пользователю перетаскивать заданный спрайт (растровый графический объект, легко перемещаемый по экрану).	Sprite
		stopDrag():void Завершает метод startDrag().	Sprite
		swapChildren(child1:DisplayObject, child2:DisplayObject):void Меняет местами (в порядке "от начала к концу") два заданных дочерних объекта.	DisplayObjectContainer
		swapChildrenAt(index1:int, index2:int):void Меняет местами (в порядке "от начала к концу") дочерние объекты, расположенные в двух заданных позициях индекса в списке потомков.	DisplayObjectContainer
		toString():String Возвращает строковое представление заданного объекта.	Object
		validateNow():void Проверяет и обновляет свойства и макет этого объекта, а также перерисовывает его при необходимости.	UIComponent
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object
		willTrigger(type:String):Boolean Проверяет, зарегистрирован ли прослушиватель событий в объекте EventDispatcher или в любом из его предков для получения уведомлений о событиях определенного типа.	EventDispatcher

Защищенные методы

Показать унаследованные защищенные методы

	Метод		Определено
		getStyleValue(name:String):Object Возвращает указанный стиль для компонента, учитывая все стили, заданные на глобальном уровне, уровне компонентов и уровне экземпляров.	UIComponent

События

Скрыть унаследованные события

Показать унаследованные события

	Сводка	Определено
activate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player перемещается в фокус операционной системы и становится активным.	EventDispatcher
added	Отправляется, когда экранный объект добавляется в список отображения.	DisplayObject
addedToStage	Отправляется, когда экранный объект добавляется к списку отображения в рабочей области, либо непосредственно, либо путем добавления поддерева, содержащего экранный объект.	DisplayObject
buttonDown	Отправляется, когда пользователь нажимает компонент Button.	BaseButton
change	Отправляется, когда изменяется значение выбранного свойства для компонента переключателя Button.	BaseButton
clear	Отправляется, когда пользователь выбирает команду "Удалить" в контекстном меню текста.	InteractiveObject
click	Отправляется при нажатии на кнопку переключателя (мышью или с помощью клавиши "Пробел").	LabelButton
copy	Отправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Копировать", или выбирает команду "Копировать" из контекстного меню.	InteractiveObject
cut	Отправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Вырезать", или выбирает команду "Вырезать" из контекстного меню.	InteractiveObject
deactivate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player покидает фокус операционной системы и становится неактивным.	EventDispatcher
doubleClick	Отправляется, когда пользователь дважды нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject, а флаг doubleClickEnabled для этого объекта имеет значение true.	InteractiveObject
enterFrame	[многоадресное событие] Отправляется, когда точка воспроизведения переходит в новый кадр.	DisplayObject
exitFrame	[многоадресное событие] Отправляется, когда точка воспроизведения покидает текущий кадр.	DisplayObject
focusIn	Отправляется, когда экранный объект перемещается в фокус.	InteractiveObject
focusOut	Отправляется, когда экранный объект покидает фокус.	InteractiveObject
frameConstructed	[многоадресное событие] Отправляется после завершения работы конструкторов экранных объектов кадра до выполнения сценариев кадра.	DisplayObject
hide	Отправляется, когда видимый компонент становится невидимым.	UIComponent
keyDown	Отправляется, когда пользователь нажимает клавишу.	InteractiveObject
keyFocusChange	Отправляется, когда пользователь пытается изменить фокус с помощью клавиатуры.	InteractiveObject
keyUp	Отправляется, когда пользователь отпускает клавишу.	InteractiveObject
labelChange	Отправляется при изменении значения метки.	LabelButton
mouseDown	Отправляется, когда пользователь нажимает кнопку на указывающем устройстве над экземпляром InteractiveObject в окне проигрывателя Flash Player.	InteractiveObject
mouseFocusChange	Отправляется, когда пользователь пытается изменить фокус с помощью указывающего устройства.	InteractiveObject
mouseMove	Отправляется, когда пользователь перемещает указывающее устройство в момент, когда курсор находится над объектом InteractiveObject.	InteractiveObject
mouseOut	Отправляется, когда пользователь перемещает указывающее устройство от экземпляра InteractiveObject.	InteractiveObject
mouseOver	Отправляется, когда пользователь наводит указывающее устройству на экземпляр InteractiveObject в окне проигрывателя Flash Player.	InteractiveObject
mouseUp	Отправляется, когда пользователь отпускает кнопку на указывающем устройстве над экземпляром InteractiveObject в окне проигрывателя Flash Player.	InteractiveObject
mouseWheel	Отправляется, когда пользователь вращает колесико мыши над экземпляром InteractiveObject в окне проигрывателя Flash Player.	InteractiveObject
move	Отправляется при перемещении компонента.	UIComponent
paste	Отправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Вставить", или выбирает команду "Вставить" из контекстного меню.	InteractiveObject
removed	Отправляется перед удалением экранного объекта из списка отображения.	DisplayObject
removedFromStage	Отправляется перед удалением экранного объекта из списка отображения, либо непосредственно, либо путем удаления поддерева, содержащего экранный объект.	DisplayObject
render	[многоадресное событие] Отправляется перед обновлением и визуализацией списка отображения.	DisplayObject
resize	Отправляется при изменении размеров компонента.	UIComponent
rollOut	Отправляется, когда пользователь перемещает указывающее устройство от экземпляра InteractiveObject.	InteractiveObject
rollOver	Отправляется, когда пользователь наводит указывающее устройство на экземпляр InteractiveObject.	InteractiveObject
selectAll	Отправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Выделить все", или выбирает команду "Выделить все" из контекстного меню.	InteractiveObject
show	Отправляется, когда невидимый компонент становится видимым.	UIComponent
tabChildrenChange	Отправляется, когда изменяется значение свойства tabChildren объекта.	InteractiveObject
tabEnabledChange	Отправляется при изменении флага tabEnabled объекта.	InteractiveObject
tabIndexChange	Отправляется, когда изменяется значение свойства tabIndex объекта.	InteractiveObject

Стили

Скрыть унаследованные стили

Показать унаследованные стили

	Описание	Определено
disabledIcon	Тип: Class Имя класса, используемого в качестве значка, когда кнопка не отключена.	LabelButton
disabledSkin	Тип: Class Имя класса, используемого в качестве обложки для фона и границы, когда кнопка не выделена и отключена.	LabelButton
disabledTextFormat	Тип: flash.text.TextFormat Объект TextFormat, который используется для визуализации метки компонента, когда кнопка отключена.	UIComponent
downIcon	Тип: Class Имя класса, используемого в качестве значка, когда кнопка не выбрана, а кнопка мыши нажата.	LabelButton
downSkin	Тип: Class Имя класса, используемого в качестве обложки для фона и границы, когда кнопка-переключатель не выделена, а кнопка мыши нажата.	LabelButton
embedFonts	Тип: Boolean Указывает, необходимо ли использовать для визуализации текстового поля контуры встроенных шрифтов.	LabelButton
emphasizedPadding	Тип: Number Формат: Length Заполнитель, который будет окружать кнопки в выделенной обложке, в пикселах. Значение по умолчанию `2`.	Button
emphasizedSkin	Тип: Class Обложка, используемая при выделении кнопки. Значение по умолчанию `Button_emphasizedSkin`.	Button
focusRectPadding	Тип: Number Формат: Length Заполнитель, отделяющий внешние границы компонента от внешних краев индикатора фокуса, в пикселах.	UIComponent
focusRectSkin	Тип: Class Обложка, используемая для показа индикаторов фокуса.	UIComponent
icon	Тип: Class Имя класса, используемого в качестве значка, когда кнопка-переключатель не выбрана, а мышь не находится над компонентом.	LabelButton
overIcon	Тип: Class Имя класса, используемого в качестве значка, когда кнопка не выбрана, а мышь находится над компонентом.	LabelButton
overSkin	Тип: Class Имя класса, используемого в качестве обложки для фона и границы, когда кнопка-переключатель не выделена, а мышь находится над компонентом.	LabelButton
repeatDelay	Тип: Number Формат: Time Количество миллисекунд ожидания, которое проходит после того, как событие `buttonDown` впервые отправляется перед отправкой второго события `buttonDown`.	LabelButton
repeatInterval	Тип: Number Формат: Time Интервал в миллисекундах между событиями `buttonDown`, которые отправляются после задержки, указанной с помощью стиля `repeatDelay`.	LabelButton
selectedDisabledIcon	Тип: Class Имя класса, используемого в качестве значка, когда кнопка выбрана и отключена.	LabelButton
selectedDisabledSkin	Тип: Class Имя класса, используемого в качестве обложки для фона и границы, когда выделена и отключена кнопка-переключатель.	LabelButton
selectedDownIcon	Тип: Class Имя класса, используемого в качестве значка, когда выбрана кнопка, а кнопка мыши нажата.	LabelButton
selectedDownSkin	Тип: Class Имя класса, используемого в качестве обложки для фона и границы, когда выделена кнопка-переключатель, а кнопка мыши нажата.	LabelButton
selectedOverIcon	Тип: Class Имя класса, используемого в качестве значка, когда выбрана кнопка, а мышь находится над компонентом.	LabelButton
selectedOverSkin	Тип: Class Имя класса, используемого в качестве обложки для фона и границы, когда выделена кнопка-переключатель, а мышь находится над компонентом.	LabelButton
selectedUpIcon	Тип: Class Имя класса, используемого в качестве значка, когда выбрана кнопка, а кнопка мыши не нажата.	LabelButton
selectedUpSkin	Тип: Class Имя класса, используемого в качестве обложки для фона и границы, когда выделена кнопка-переключатель, а мышь не находится над компонентом.	LabelButton
textFormat	Тип: flash.text.TextFormat Объект TextFormat, используемый для визуализации метки компонента.	UIComponent
textPadding	Тип: Number Формат: Length Расстояние между текстом и границами компонента, а также расстояние между текстом и значком, в пикселах.	LabelButton
upIcon	Тип: Class Имя класса, используемого в качестве значка, когда кнопка-переключатель не выбрана, а мышь не находится над компонентом.	LabelButton
upSkin	Тип: Class Имя класса, используемого в качестве обложки для фона и границы, когда кнопка-переключатель не выделена, а мышь не находится над компонентом.	LabelButton

Сведения о свойстве

emphasized

свойство

emphasized:Boolean [чтение и запись]

Язык версии :

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9.0.28.0

Определяет или задает логическое значение, указывающее, отрисовывается ли граница вокруг компонента Button, когда кнопка не нажата. Значение true указывает, что кнопка окружена границей, если не нажата; значение false указывает на отсутствие границы.

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

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

См. также

emphasizedPadding
emphasizedSkin

Пример

В следующем примере стиль emphasizedPadding экземпляра Button основан на значении компонента Slider:


import fl.controls.Button;
import fl.controls.Slider;
import fl.events.SliderEvent;

var styleObject:Object = Button.getStyleDefinition();
var defaultEmphasizedPadding:uint = styleObject.emphasizedPadding;

var myButton:Button = new Button();
myButton.label = "emphasizedPadding:" + defaultEmphasizedPadding;
myButton.emphasized = true;
myButton.width = 150;
myButton.move(20, 20);
addChild(myButton);

var mySlider:Slider = new Slider();
mySlider.snapInterval = 1;
mySlider.tickInterval = 1;
mySlider.liveDragging = true;
mySlider.value = defaultEmphasizedPadding;
mySlider.width = myButton.width;
mySlider.move(20, 60);
mySlider.addEventListener(SliderEvent.CHANGE, changeHandler);
addChild(mySlider);

function changeHandler(event:SliderEvent):void {
    myButton.label = "emphasizedPadding:" + event.value;
    myButton.setStyle("emphasizedPadding", event.value);
}

Сведения о конструкторе

Button

()

Конструктор

public function Button()

Язык версии :

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9.0.28.0

Создает новый экземпляр компонента Button.

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

getStyleDefinition

()

метод

public static function getStyleDefinition():Object

Язык версии :

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9.0.28.0

Возвращает карту стилей по умолчанию для текущего компонента. Карта стилей содержит тип, который подходит для компонента в зависимости от стиля, используемого компонентом. Например, стиль disabledTextFormat содержит значение null или объект TextFormat. Вы можете воспользоваться этими стилями и вызвать метод setStyle() по отношению к текущему компоненту. Следующий код переопределяет стиль disabledTextFormat, выбранный по умолчанию для указанного компонента:

componentInstance.setStyle("disabledTextFormat", new TextFormat());

Возвращает

Object — Объект стилей по умолчанию.

См. также

UIComponent.getStyle()
UIComponent.setStyle()
StyleManager

Пример

В следующем примере создается обозреватель стилей для нескольких классов компонентов:

import fl.controls.*;
import fl.containers.*;
import fl.controls.listClasses.*;
import fl.controls.dataGridClasses.*;
import fl.controls.progressBarClasses.*;
import fl.core.UIComponent;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem( { label: "BaseScrollPane",    data:BaseScrollPane } );
dp.addItem( { label: "Button",             data:Button } );
dp.addItem( { label: "CellRenderer",    data:CellRenderer } );
dp.addItem( { label: "CheckBox",         data:CheckBox } );
dp.addItem( { label: "ColorPicker",     data:ColorPicker } );
dp.addItem( { label: "ComboBox",         data:ComboBox } );
dp.addItem( { label: "DataGrid",         data:DataGrid } );
dp.addItem( { label: "HeaderRenderer",    data:HeaderRenderer } );
dp.addItem( { label: "ImageCell",        data:ImageCell } );
dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } );
dp.addItem( { label: "Label",             data:Label } );
dp.addItem( { label: "List",             data:List } );
dp.addItem( { label: "NumericStepper",     data:NumericStepper } );
dp.addItem( { label: "ProgressBar",     data:ProgressBar } );
dp.addItem( { label: "RadioButton",     data:RadioButton } );
dp.addItem( { label: "ScrollPane",         data:ScrollPane } );
dp.addItem( { label: "Slider",             data:Slider } );
dp.addItem( { label: "TextArea",         data:TextArea } );
dp.addItem( { label: "TextInput",         data:TextInput } );
dp.addItem( { label: "TileList",         data:TileList } );
dp.addItem( { label: "UILoader",         data:UILoader } );
dp.addItem( { label: "UIComponent",     data:UIComponent } );

var cb:ComboBox = new ComboBox();
cb.move(10,10);
cb.setSize(300,25);
cb.prompt = "Select a component to view its styles";
cb.rowCount = 12;
cb.dataProvider = dp;
cb.addEventListener(Event.CHANGE, showStyleDefinition);
addChild(cb);

var dg:DataGrid = new DataGrid();
dg.setSize(425,300);
dg.move(10,50);
dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ];
addChild(dg);

function showStyleDefinition(e:Event):void {
    var componentClass:Class = e.target.selectedItem.data as Class;
    var styles:Object = componentClass["getStyleDefinition"].call(this);
    trace(styles.toString());
    var styleData:DataProvider = new DataProvider();
    for(var i:* in styles) {
        trace(i + " : " + styles[i]);
        styleData.addItem( { StyleName:i, DefaultValue:styles[i] } );
    }
    styleData.sortOn("StyleName");
    dg.dataProvider = styleData;
}

Примеры Как пользоваться примерами

ButtonExample.as

В этом примере показано, как создавать кнопки и динамически применять к ним стили.

Добавьте Button в библиотеку.
Сохраните этот код под именем ButtonExample.as в том же каталоге, где и FLA-файл.
Присвойте параметру DocumentClass в FLA-файле значение ButtonExample.

package
{
    import flash.display.MovieClip;
    import flash.events.MouseEvent;
    import flash.text.TextField;
    import flash.text.TextFormat;
    import fl.controls.Button;
    
    public class ButtonExample extends MovieClip
    {
        private var b1:Button;
        private var b2:Button;        
        private var b3:Button;
        private var tf:TextField;
        
        public function ButtonExample() {
            createTraceField();
            setupButtons();
        }
        private function createTraceField():void {
            tf = new TextField();
            tf.width = 200;
            tf.height = 400;
            tf.x = 200;
            tf.y = 10;
            addChild(tf);
        }
        private function setupButtons():void {
            b1 = new Button();
            b2 = new Button();
            b3 = new Button();

            b1.move(10,10);
            b2.move(10,40);
            b3.move(10,70);

            b1.label = "Default Button";
            b2.label = "Custom Styled Button";
            b3.label = "Toggleable Button";
            b2.setStyle("textFormat", new TextFormat("Georgia"));
            b3.width = 120;
            b3.toggle = true;
            
            b1.addEventListener(MouseEvent.CLICK,buttonClick);
            b2.addEventListener(MouseEvent.CLICK,buttonClick);
            b3.addEventListener(MouseEvent.CLICK,buttonClick);

            addChild(b1);
            addChild(b2);
            addChild(b3);
        }
        private function buttonClick(e:MouseEvent) {
            var button:Button = Button(e.target);
            tf.appendText(button.label + "\n");
        }
    }
}

Справочник по языку ActionScript 3.0 и компонентам		Home \| Все пакеты \| Все классы \| Элементы языка \| Указатель \| Приложения \| Сокращения \| Кадры Нет кадров
Button	Свойства \| Методы \| События \| Стили \| Эффекты \| Константы \| Примеры